# @napi-rs/wasm-runtime 中文文档

规范地址：https://npmcn.com/package/%40napi-rs/wasm-runtime/

版本：1\.2\.7
npm 元数据更新时间：2026-11-03T04:09:58.937Z
中文译文更新时间：2026-11-05T16:01:31.648Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40napi-rs/wasm-runtime
原文对照：https://npmcn.com/package/%40napi-rs/wasm-runtime/?lang=original
项目主页：https://napi.rs/
源码仓库：https://github.com/napi-rs/napi-rs

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：782 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- Node.js 要求：^20\.19\.0 \|\| ^22\.13\.0 \|\| \>=23\.5\.0
- 运行依赖：1 个
- peer 依赖：@emnapi/core ^1\.7\.1 \|\| 2\.0\.0-beta\.2 \|\| 2\.0\.0-beta\.3，@emnapi/runtime ^1\.7\.1 \|\| 2\.0\.0-beta\.2 \|\| 2\.0\.0-beta\.3
- 首次发布：2024-01-16T16:01:50.482Z
- 最新版本发布：2026-11-03T04:09:58.667Z
- 近 30 天下载量：255147006（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 15 个）

## 中文简介

原子弹目标的运行时间和多填充

## 安装

```sh
npm install @napi-rs/wasm-runtime
```

也可以使用：`pnpm add @napi-rs/wasm-runtime`、`yarn add @napi-rs/wasm-runtime`、`bun add @napi-rs/wasm-runtime`

## README

# @napi-rs/wasm-runtime (英语)

运行时辅助器和浏览器多填充器,用于 supi-rs WebAssembly addons .

## emnapi 兼容性

使用匹配的版本 `@emnapi/core` 财务报告和审定财务报表 `@emnapi/runtime`数字 :

-   v1: (英语) `^1.7.1`。核心包括同步工作和线程安全功能,并忽略 插件选项 。 装入此软件包不会解决 v2 `@emnapi/core/plugins` 输出.
-   v2: 对等距离是准确的 `2.0.0-beta.2` 或者说 `2.0.0-beta.3`这个 软件包捆绑来自 Aync-work 和 TSFN 插件 `2.0.0-beta.3`他们 依赖于私有的核心上下文字段,这两个字都一样 (单位:千美元)`2.0.0-beta.3` 仅更改了 TSFN 发布命令 . `2.0.0-beta.1` 已更名 上下文字段 `napiModule` 改为 `addonModule`; 捆绑的插件接受 两个名字,所以绑定 针 2.0.0α继续加载。 一会儿 重新改变上下文的预释需要重新发布此 软件包.

V2 对等范围故意保持狭窄. 在开放范围内,npm可以竖起a 绑定此套件旁边的 2. 0.0 α 核心, 然后 v1 绑定 通过无害环境管理条目或跳过普通JS副本的工具加载 找下面,拿个V2核心 Npm 将安装一个 v1 核心,用于窄范围 当绑定的 pins 给另一个 v2 预放时 , 此软件包 。 装订是自己的 如下文所述,emnapi副本仍在运行.

当此软件包的对等端解决时, CommunityJS 条目将 Emnapi 复制件分开 与装订本不同的副本 `@emnapi/core` 财务报告和审定财务报表 `@emnapi/runtime` (两个绑住不同的emnapi版本,说):

-   `instantiateNapiModule(Sync)` 运行创建运行时间的副本的核心 `options.context`它发现运行时间在 `require.cache` 并解决 从需要它(装订器)的模块核心.
-   `getDefaultContext`, (中文(简体) ), `createContext`, (中文(简体) ), `MessageHandler`即时 不包含上下文, 在同时声明时使用调用软件包的副本 作为依赖的 Emnapi 软件包: 仍在装入的普通JS 模块 并且需要这个包裹,或者,在工人的线条,工人的入门文件.
-   当选中的核心为 v2 时, 捆绑的插件将被该核心的替换 拥有 `@emnapi/core/plugins`。 。 。 .
-   其他任何东西都使用这个软件包的同位素. 其它 emnapi 的背景 生成来自未知副本 `TypeError` 这么说的.

无害环境管理条目由捆绑者解决,无法做到这一点。 它使用捆绑 带有该插件 `addonModule` 别名.

为生 `instantiateNapiModule` 编号 : `instantiateNapiModuleSync` 调用加载a 单行道的相接器 `plugins: [emnapiAsyncWorkPlugin, emnapiTSFNPlugin]` 从这个包裹。 已生成 美洲狮加载器已经提供了这些插件.

## 更新捆绑的插件

与工作空间一起更新精确 v2 开发依赖 决议. `build` 检查解析的核心版本是否准确 开发版本和同位素范围的 v2 版本之一,以及 `prepack` 重建捆绑,使一个软件包不能静默地再利用输出 之前的建筑。 在发布前,将新插件上下文与 最古老支持的α (`2.0.0-alpha.3` 是最古老的 仍然被出版 并保留CI矩阵。 保留较早的 v2 版本 发布绑定时的对等范围 `2.0.0-beta.2`); 删除一个使 npm 为此软件包安装了 v1 核心 旁边的绑着.

`yarn workspace @napi-rs/wasm-runtime test` 实际网络大会 初始化、合成工作、TSFN电话、工人负载故障和 通过两种模块格式进行清理。 CI 也安装已包装的柏油球 工作空间外的真实 v1 和 v2 的同位素, 以避免根分辨率覆盖 .

## 常见问题

### @napi-rs/wasm-runtime 是什么？

原子弹目标的运行时间和多填充

### 如何安装 @napi-rs/wasm-runtime？

在项目目录运行 npm install @napi-rs/wasm-runtime，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@emnapi/core（^1\.7\.1 \|\| 2\.0\.0-beta\.2 \|\| 2\.0\.0-beta\.3）、@emnapi/runtime（^1\.7\.1 \|\| 2\.0\.0-beta\.2 \|\| 2\.0\.0-beta\.3）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @napi-rs/wasm-runtime 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/napi-rs\_\_wasm-runtime 是否存在。

### @napi-rs/wasm-runtime 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @napi-rs/wasm-runtime 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^20\.19\.0 \|\| ^22\.13\.0 \|\| \>=23\.5\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @napi-rs/wasm-runtime 可以商用吗？

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

### @napi-rs/wasm-runtime 的下载量有多少？

根据 npm 官方下载统计，@napi-rs/wasm-runtime 在 2026/10/05 – 2026/11/03 这 30 天内被下载 255,147,006 次，日均约 8,504,900 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @napi-rs/wasm-runtime 还在维护吗？

最新版本 1\.2\.7 发布于 2026/11/03（2 天前）；至今共发布 39 个版本，其中过去 12 个月发布了 15 个；首次发布于 2024/01/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。