常见问题 ​

emnapi 和原生 Node-API 有什么区别 ​

• emnapi 的大部分 API 是由 JavaScript 实现的，而原生 Node-API 是由 Node.js C++ 代码实现的，并且可以完全访问 V8 引擎。

• emnapi 由 Emscripten 编译成 WebAssembly，而原生 Node-API 被编译成 Node.js 扩展（.node 是操作系统动态链接库），可以使用操作系统 API。

• emnapi 没有 Node.js 特定的 API，一些 API 依赖于宿主 JavaScript 环境，特别是 WebAssembly 不与宿主共用堆内存，与 ArrayBuffer 相关的 API 存在一定的限制，请参阅 API 列表

• 如果运行时支持 FinalizationRegistry 和 WeakRef，则使用 emnapi 时可以直接使用内置的 node-addon-api。

我什么时候应该用 emnapi ​

• 你更喜欢 Node-API，并且相比于 embind 你更熟悉 Node-API。
• 你希望将你的（或现成的）用 Node-API 编写的 Node.js 扩展移植到 WebAssembly。
• 你希望你的原生模块 npm 包可以顺利地被用户安装，而无需面对 node-gyp。

如何移植现成的用 Node-API 编写 Node.js 扩展 ​

1. 检查扩展中使用的所有 API 是否在 emnapi 中已被实现。请参阅 API 列表。
2. 在调用 napi_create_reference / napi_wrap 之前使用 emnapi_is_support_weakref 检查运行时的弱引用支持。
3. 检查是否需要同步 wasm 内存，根据 ArrayBuffer 相关的 API
4. 编写 CMakeLists。不支持 node-gyp。