如何移除Emscripten生成的JS文件，在Node.js中直接执行WebAssembly

我计划开发一个基于Node.js的原生代码库，尝试使用WebAssembly技术。目前能将C代码编译为WebAssembly，但Emscripten会同时生成.wasm和.js文件。我知道背后有运行时依赖，但想了解是否能绕过生成的JS文件，直接加载WebAssembly并调用其中的函数。

原有可运行流程 #

main.c代码

#include <stdio.h>
#include <emscripten/emscripten.h>

EMSCRIPTEN_KEEPALIVE
void hello() {
  printf("Hello world!\n");
}

index.js代码

var a = require("./a.out.js");

a().then((instance) => {
  instance.ccall("hello"); // Prints "Hello World!"
});

编译命令

emcc -s NO_EXIT_RUNTIME=1 -sMODULARIZE -s "EXPORTED_RUNTIME_METHODS=['ccall']" main.c

运行命令

node index.js

直接加载Wasm的报错代码 #

const fs = require("node:fs");

const wasmBuffer = fs.readFileSync("a.out.wasm");
WebAssembly.instantiate(wasmBuffer).then((wasmModule) => {
  const { hello } = wasmModule.instance.exports;
  hello();
});

报错信息

node index.js
node:internal/process/promises:288
            triggerUncaughtException(err, true /* fromPromise */);
            ^

[TypeError: WebAssembly.instantiate(): Imports argument must be present and must be an object]

Node.js v18.18.2

解决方案 #

直接加载Wasm报错的核心原因：Emscripten编译出的Wasm模块依赖Emscripten运行时的导入对象（比如printf这类标准库函数需要JS端实现的运行时支持），直接调用WebAssembly.instantiate时未提供这些必要导入，导致报错。

方法1：编译为无标准库依赖的纯Wasm模块（推荐无标准库需求场景）

如果你的C代码不需要printf等标准库函数，可以编译成不依赖Emscripten运行时的独立Wasm模块：

1. 修改main.c（移除标准库依赖）：

#include <emscripten/emscripten.h>

EMSCRIPTEN_KEEPALIVE
void hello() {
  // 编写无标准库依赖的业务逻辑
}

2. 编译命令：

emcc main.c -s STANDALONE_WASM=1 -o main.wasm

3. 直接加载的Node.js代码：

const fs = require("node:fs");

const wasmBuffer = fs.readFileSync("main.wasm");
WebAssembly.instantiate(wasmBuffer).then((wasmModule) => {
  const { hello } = wasmModule.instance.exports;
  hello();
});

方法2：手动提供必要的运行时导入对象（适用于依赖标准库的场景）

如果必须使用printf等标准库函数，需要手动构建Wasm模块要求的导入对象。Emscripten生成的JS文件本质就是自动处理了这些导入和初始化，你可以从生成的JS文件中提取必要部分：

1. 编译时指定导出函数：

emcc main.c -s NO_EXIT_RUNTIME=1 -s EXPORTED_FUNCTIONS=['_hello'] -o main.js

2. 手动构建导入对象并加载Wasm：

const fs = require("node:fs");
const wasmBuffer = fs.readFileSync("main.wasm");

// 手动构建Emscripten运行时所需的导入对象，需根据实际依赖调整
const imports = {
  env: {
    printf: (format) => {
      // 实现printf的简易版本，或直接调用Node.js的console
      console.log("Hello world!");
    },
    __stdio_putc: (c) => {
      // 实现字符输出逻辑
    },
    __emscripten_get_heap_size: () => 16777216,
    __emscripten_resize_heap: () => 1,
    // 其他必要的运行时函数需从生成的main.js中提取
  }
};

WebAssembly.instantiate(wasmBuffer, imports).then((wasmModule) => {
  const { _hello } = wasmModule.instance.exports; // Emscripten会给C函数加下划线前缀
  _hello();
});

注意：这种方法需要手动维护导入对象，当代码依赖的标准库功能变化时，需同步更新导入逻辑，维护成本较高。如果项目依赖较多标准库功能，建议直接使用Emscripten生成的JS文件，它会自动处理所有运行时依赖和初始化工作。

内容的提问来源于stack exchange，提问作者Rodrigo