@boltffi/runtime

中文文档
0.32.1发布于 2026/10/30MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 19.2万

BoltFFI 的 WASM 运行时间生成了类型脚本绑定

中文使用文档
文档目录6 节
  1. 安装
  2. 使用量
  3. 示例
  4. 调用 JavaScript 的不可靠依赖
  5. 文档
  6. 许可证

@ boltffi/ 运行时间

WASM 运行时间 博尔特福尔 生成类型脚本绑定 .

安装

npm install @boltffi/runtime

使用量

这个软件包由BoltFFI所生成的WASM捆绑在内部使用. 您不需要直接安装它 - 运行时它与您的生成的软件包捆绑 boltffi pack wasm。 。 。 .

示例

当你跑的时候 boltffi pack wasm,生成的 TypeScript 使用此运行时间 :

import { distance } from 'your-package';

const d = distance({ x: 0, y: 0 }, { x: 3, y: 4 });
console.log(d); // 5.0

调用 JavaScript 的不可靠依赖

导出的 Rust 函数可以使用依赖性, 如 uuid 联合国 v4 财务报告和审定财务报表 js 特性。 该函数仍然使用 #[boltffi::export]。无 #[wasm_bindgen] 属性需要在 BoltFFI API 上.

boltffi pack wasm 已编译的文物中的元数据 在剥离或优化之前运行匹配的正弦 CLI。 这个 生成的软件包中包含 BoltFFI 绑定和依赖 JavaScript 绑定,连接到相同的Wasm实例. 货物原件 保存文物,包括再次包装时 --no-build。 。 。 .

在包错误中安装精确的 CLI 版本 cargo install wasm-bindgen-cli --version =VERSION --locked。现有 可选择可执行文件 BOLTFFI_WASM_BINDGEN 或者说 targets.wasm.wasm_bindgen_cli 内 boltffi.toml。没有原站点的模块 元数据不需要此工具 。 TypeScript 汇编需要此运行时间 而对于节点入口, @types/node 在输出位置安装 父目录可以解析它们.

生成的加载器支持节点同步初始化,一个同步 初始化、 浏览器获取和捆绑器 。 一个 JavaScript 胶水模块拥有 一个瓦斯姆的例子。 再次同时或失败后初始化 依赖启动被拒绝 。 本地和内置的 JavaScript 片断为 包含; npm 导入和动态计算模块路径被拒绝 包装时.

依赖启动时可以使用函数, 因此 JavaScript 可以调回 进入BoltFFI。 计算常数在启动后被读取,并在 初始化完成 。 他们的Rust转换之后也可以使用JavaScript.

这一一体化目标 wasm32-unknown-unknown 与非共享内存和 panic=abort线条,JSPI,和恐慌的解开 都在这份合同之外. 主机必须提供JavaScript APIs的依赖呼叫;浏览器 DOM APIs, 例如,普通节点程序中不可用。 未抓取的 Java 脚本 例外和 Rust 陷阱保留他们的 Web Assembly语义。 他们没有 成为博尔特FFI Result 值或使实例安全地重复使用. 如果投票或取消未来,所有待决的博尔特FFI期货都会拒绝 而那个案子的Aync经理 停止投票。 丢弃失败实例 .

BoltFFI 合成出口仍然需要 Send 未来 原子弹 JsFuture 不满足这个约束。 JavaScript 任务可以完成等待的频道 正如Wasm Interop演示所显示的.

文档

许可证

麻省理工学院

版本与发布记录

@boltffi/runtime 共发布 34 个版本,首次发布于 2026/02/17;过去 12 个月发布了 34 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.32.1latest2026/10/309 天前
0.32.02026/10/2811 天前
0.31.12026/10/1424 天前
0.31.02026/09/291 个月前
0.30.12026/08/182 个月前
0.30.02026/08/152 个月前

关于 @boltffi/runtime 的常见问题

@boltffi/runtime 是什么?

BoltFFI 的 WASM 运行时间生成了类型脚本绑定

如何安装 @boltffi/runtime?

在项目目录运行 npm install @boltffi/runtime,或使用 pnpm add / yarn add / bun add。

@boltffi/runtime 支持 TypeScript 吗?

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

@boltffi/runtime 支持 ESM 还是 CommonJS?

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

@boltffi/runtime 可以商用吗?

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

@boltffi/runtime 的下载量有多少?

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

@boltffi/runtime 还在维护吗?

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