@chialab/rna-dev-server

中文文档
0.19.0发布于 2026/08/07MITTypeScriptES Module构建来源已验证近 30 天下载 3052

A webapp server based on Web Dev Server.

原始使用文档
文档目录7 节
  1. Install
  2. Usage
  3. Via import
  4. Via cli
  5. As middleware
  6. Integrations
  7. License

RNA Dev Server

A webapp server based on Web Dev Server.

[!CAUTION] RNA cli development is deprecated and discontinued. It's recommended to use RNA plugins directly in your projects using vite, esbuild, or other supported tools.

NPM

Install

npm i @chialab/rna-dev-server -D
yarn add @chialab/rna-dev-server -D
pnpm add @chialab/rna-dev-server -D

Usage

Start a web dev server that transforms ESM imports for node resolution on demand. It also uses esbuild to compile non standard JavaScript syntax.

Via import

import { serve } from '@chialab/rna';

/**
 * @see https://modern-web.dev/docs/dev-server/cli-and-configuration/
 */
await serve({
    // rootDir: '.',
});

Via cli

rna serve [options] [root]

Options:
  -P, --port <number>  server port number
  -C, --config <path>  the rna config file
  -h, --help           display help for command

Samples

rna serve
rna serve public --port 3000

As middleware

import { createServer } from 'http';
import { createDevServer, loadDevServerConfig } from '@chialab/rna-dev-server';
import express from 'express';

const app = express();
const server = createServer(app);
const config = await loadDevServerConfig({
    rootDir: 'src',
});
const devServer = await createDevServer(config);
await devServer.start(server);
app.use(devServer.callback());

Integrations

  • RNA CakePHP: a view helper to inject scripts and css with livereload.

License

RNA Dev Server is released under the MIT license.

版本与发布记录

@chialab/rna-dev-server 共发布 175 个版本,首次发布于 2021/05/25;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.19.0latest2026/08/073 个月前
1.0.22026/06/234 个月前
1.0.12026/02/258 个月前
1.0.0-beta.1beta2024/07/092 年前
1.0.0-beta.02024/03/112 年前
0.18.02024/01/112 年前

其他发布通道:alpha → 0.18.0-alpha.1,beta → 1.0.0-beta.1。

关于 @chialab/rna-dev-server 的常见问题

@chialab/rna-dev-server 是什么?

A webapp server based on Web Dev Server.

如何安装 @chialab/rna-dev-server?

在项目目录运行 npm install @chialab/rna-dev-server,或使用 pnpm add / yarn add / bun add。

@chialab/rna-dev-server 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@chialab/rna-dev-server 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@chialab/rna-dev-server 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@chialab/rna-dev-server 可以商用吗?

@chialab/rna-dev-server 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@chialab/rna-dev-server 的下载量有多少?

根据 npm 官方下载统计,@chialab/rna-dev-server 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,052 次,日均约 102 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chialab/rna-dev-server 还在维护吗?

最新版本 0.19.0 发布于 2026/08/07(3 个月前);至今共发布 175 个版本,其中过去 12 个月发布了 3 个;首次发布于 2021/05/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。