3202年了,你还在用express写Node服务吗?
最近我在给 AirCode 写写代码,调研了很多 Serverless/FaaS 的产品和社区,重新思考了一下 Node.js 服务端框架的发展。
众所周知,现在前端框架如雨后春笋,前有react、vue,后有 svelte、solid 等等,以及一些前端+BFF的社区也层出不穷,代表的如 react 技术栈的 Next.js,vue 技术栈的 Nuxt.js。各种 Runtime 发展也很快,除了传统的 Node,还有 Deno、Bun 以及 Edge Runtime 等。然而中间层的服务端框架似乎有些断层,很多人还在使用 Express 或者 Koa、新一点的 Fastify 也是3、4年前诞生的,用的都是相对比较传统的设计思想。
我想既然前(FE+BFF)后(Runtime)都有不少新东西,那么中间的 Framework 也可以卷一卷,所以利用研究 AirCode 的机会,我在思考能不能设计一个轻量级的 FaaS 框架,让它既能很方便地运行于本地,又能够在将来需要上线部署的时候可以无缝地一键部署到 AirCode 平台上。
于是,这个新的框架 Hydrogen 诞生了。

这个新框架我给命名为 Hydrogen,是氢元素的意思,既呼应 AirCode 的 Air,又表示这是一个极简单轻量的框架。
框架特性
它有如下的特性:
- 🐇 内置 HMR(Hot Module Replacement)支持快速开发🔥
- 📦 支持 CommonJS (.js .cjs)、ES 模块 (.mjs) 和 TypeScript (.ts) 函数,开箱即用。
- 🧸 几乎不需要任何配置。
- 🗄️ 内置了现成的文本数据库和文件 API。
- 📁 遵循直观的目录结构约定。
- 🤏 采用纯 JavaScript 编写,设计简洁美观。
- ⚡️ 无论是开发环境还是生产环境,都优化了运行性能。
- 🧊 兼容并能够在 AirCode 平台上无缝运行您的应用。
快速启用
只要你的 Node.js 版本在 14+,只需要以下两行命令就可以快速创建并启动项目:
- Create an aircode app
npx create-aircode-app@latest my-aircode-app && cd my-aircode-app
- Install dependencies and run
npm i && npm start
项目目录结构
Hydrogen 采用非常简单直观的项目目录结构
├──functions # put your function api here.
│ └── hello.js # http://localhost:3000/hello
├──public # put your static resources here.
│ └── favicon.ico # http://localhost:3000/public/favicon.ico
└── package.json
项目的云函数存放于 functions 目录下,服务启动后通过 /子目录/函数名
访问,子目录不包含 functions
目录本身。
项目的静态资源文件存放于 public 目录下,服务启动后通过 /public/子目录/文件名
访问。
创建云函数
Hydrogen 默认支持 cjs、mjs 和 ts 的云函数,你只要创建对应的 .js|.mjs|.ts
文件就可以。
云函数只需要导出一个异步函数,这个函数返回的任何数据自动被作为 response.body
返给客户端。
// hello.js or hello.cjs
const aircode = require('aircode');
module.exports = async function(params, context) {
console.log('Received params:', params);
return {
message: 'Hi, AirCode.'
};
}
// hello.mjs
import aircode from 'aircode';
export default async function (params, context) {
console.log('Received params:', params);
return {
message: 'Hi, AirCode.',
};
};
// hello.ts
import aircode from 'aircode';
export default async function (params: any, context: any) {
console.log('Received params:', params);
return {
message: 'Hi, AirCode.',
};
};
以上三个函数任何一个放在 functions
目录下,服务启动后,都可以通过路径 /hello
访问。
详细文档
Hydrogen 的云函数 params
和 context
提供了请求参数访问和各种操作方法,aircode.db
和 aircode.files
提供了内置数据库和文件API。
详细资料见下方的文档:
部署和集成
Hydrogen 项目完全兼容 AirCode 的规范,能够通过 GitHub 一键部署到 AirCode 中发布到线上运行。
这部分,后续有机会再单独详细介绍。
大家还等什么,有兴趣的同学可以访问代码仓库安装并使用 Hydrogen。
如有任何问题,欢迎留言讨论👏
转载自:https://juejin.cn/post/7263266708324433981