git clone https://github.com/toyobayashi/emnapi.gitcd ./emnapinpm install -g node-gypnpm installnpm run build # output ./packages/*/distnode ./script/release.js # output ./out# test for emscriptennpm run rebuild -w packages/testnpm run test -w packages/test# test for wasi-sdknpm run rebuild:wt -w packages/testnpm run test:wt -w packages/test
npm install -D emnapinpm install @emnapi/runtime# additionally, for wasi-sdk, install @emnapi/corenpm install @emnapi/core# if you need node-addon-apinpm install node-addon-api
import init from './out/binding.js'import { createContext } from '@emnapi/runtime'const emnapiCtx = createContext()const Module = await init()const binding = Module.emnapiInit({ context: emnapiCtx, asyncWorkPoolSize: 4 // the same effect to UV_THREADPOOL_SIZE, must less than PTHREAD_POOL_SIZE})binding.run(/* ... */)// cleanupModule._uv_library_shutdown()emnapiCtx.destroy()
# Linux or macOSexport GYP_CROSSCOMPILE=1# emscriptenexport AR_target="$EMSDK/upstream/emscripten/emar"export CC_target="$EMSDK/upstream/emscripten/emcc"export CXX_target="$EMSDK/upstream/emscripten/em++"# wasi-sdkexport AR_target="$WASI_SDK_PATH/bin/ar"export CC_target="$WASI_SDK_PATH/bin/clang"export CXX_target="$WASI_SDK_PATH/bin/clang++"
@REM Windowsset GYP_CROSSCOMPILE=1@REM emscriptencall set AR_target=%%EMSDK:\=/%%/upstream/emscripten/emar.batcall set CC_target=%%EMSDK:\=/%%/upstream/emscripten/emcc.batcall set CXX_target=%%EMSDK:\=/%%/upstream/emscripten/em++.bat@REM wasi-sdkcall set AR_target=%%WASI_SDK_PATH:\=/%%/bin/ar.execall set CC_target=%%WASI_SDK_PATH:\=/%%/bin/clang.execall set CXX_target=%%WASI_SDK_PATH:\=/%%/bin/clang++.exe
Reference for instantiateNapiModule input parameters
// emnapi main thread (could be in a Worker)instantiateNapiModule(input, { context: getDefaultContext(), asyncWorkPoolSize: 4, // the same effect to UV_THREADPOOL_SIZE, must less than `reuseWorker.size` wasi: new WASI(/* ... */), /** * Setting this to `true` or a delay (ms) makes * pthread_create() do not return until worker actually start. * It will throw error if emnapi runs in browser main thread * since browser disallow blocking the main thread (Atomics.wait). * @defaultValue false */ waitThreadStart: isNode || (isBrowser && !isBrowserMainThread), /** * Reuse the thread worker after thread exit to avoid re-creatation * @defaultValue false */ reuseWorker: { /**
Note: For browsers, all the multithreaded features relying on Web Workers (Emscripten pthread also relying on Web Workers)
require cross-origin isolation to enable SharedArrayBuffer. You can make a page cross-origin isolated
by serving the page with these headers: