什么是 binaryen.js？
binaryen.js 是 Binaryen 的 Web 版本，它允许你通过 JavaScript API 来生成 WebAssembly。简单来说，它让你在浏览器或 Node.js 环境中也能轻松操作 WebAssembly，无需依赖复杂的工具链。
如何使用 binaryen.js？
首先，你需要通过 npm 安装 binaryen：
npm install binaryen
安装完成后，你可以通过以下代码来创建一个简单的 WebAssembly 模块：
import binaryen from "binaryen";
// 创建一个包含单个函数的模块
var myModule = new binaryen.Module();
myModule.addFunction("add", binaryen.createType([binaryen.i32, binaryen.i32]), binaryen.i32, [binaryen.i32],
myModule.block(null, [
myModule.local.set(2,
myModule.i32.add(
myModule.local.get(0, binaryen.i32),
myModule.local.get(1, binaryen.i32)
)
),
myModule.return(
myModule.local.get(2, binaryen.i32)
)
])
);
myModule.addFunctionExport("add", "add");
// 使用默认的优化策略优化模块
myModule.optimize();
// 验证模块
if (!myModule.validate())
throw new Error("validation error");
// 生成文本格式和二进制格式
var textData = myModule.emitText();
var waData = myModule.emitBinary();
// 使用 WebAssembly API 进行示例调用
var compiled = new WebAssembly.Module(waData);
var instance = new WebAssembly.Instance(compiled, {});
console.log(instance.exports.add(41, 1));
如何安装 nightly 版本？
如果你想要使用最新的 nightly 版本，可以通过以下命令安装：
npm install binaryen@nightly
这个版本每天都会更新，适合那些想要体验最新功能的者。
如何通过 CDN 使用 binaryen.js？
如果你不想通过 npm 安装，也可以通过 CDN 直接引入 binaryen.js：
-
通过 jsDelivr（GitHub）：
https://cdn.jsdelivr.net/gh/AssemblyScript/binaryen.js@VERSION/index.js
-
通过 jsDelivr（npm）：
https://cdn.jsdelivr.net/npm/binaryen@VERSION/index.js
-
通过 unpkg：
https://unpkg.com/binaryen@VERSION/index.js
将 VERSION 替换为具体的版本，或者直接省略（不推荐在生产环境中使用）以使用最新版本。
命令行工具
binaryen.js 还包含了 Node.js 版本的 wa-opt 和 wa2js 工具，方便你在命令行中进行 WebAssembly 的优化和转换。
API 概览
binaryen.js 提供了丰富的 API，涵盖了从模块构建、优化到表达式操作等多个方面。以下是一些常用的 API 功能：
- 模块构建：创建、解析和读取 WebAssembly 模块。
- 模块操作：添加、删除和获取模块中的函数。
- 模块优化：使用默认策略优化模块。
- 表达式构建：创建各种类型的表达式，如整数运算、浮点运算等。
- 控制流：处理条件判断、循环等控制流操作。
- 变量访问：获取和设置局部变量。
- 内存访问：操作线性内存中的数据。
注意事项
binaryen.js 的 API 更新非常频繁，文档可能会滞后于实际功能。如果你在使用过程中发现任何问题，建议直接查看最新的 Binaryen API 文档，或者提交 PR 更新相关文档。
总结
binaryen.js 是一个强大的工具，它让 WebAssembly 的变得更加简单和灵活。无论你是想优化现有的 WebAssembly 模块，还是从头开始构建新的模块，binaryen.js 都能为你提供强大的支持。如果你对 WebAssembly 感兴趣，不妨试试 binaryen.js，体验它带来的便利。
