wasm-module-preprocessor

A general-purpose module for preprocessing WebAssembly (wasm).

Install

``bash
npm install --save-dev wasm-module-preprocessor
`

Usage

wasm-module-preprocessor by default loads wasm modules asynchronously, and
takes an optional importObject. All wasm modules are validated on build, so
that there is no need for runtime testing and beyond just validating wasm
modules, the size of the wasm module is checked too.

$3

file.wasm

`

`

test.js

`js
import wasmModulePreprocessor from 'wasm-module-preprocessor';
import { readFileSync } from 'fs';
import { runInNewContext } from 'vm';

const bufferSource = readFileSync('file.wasm');

const wasmModuleExportString = wasmModulePreprocessor(
bufferSource,
{
// Defaults to:
// sync: false,
}
);

const wasmModuleExport = runInNewContext((() => ${wasmModuleExportString})());

(async () => {
try {
const {
instance: {
exports: {
main = () => undefined,
},
},
} = await wasmModuleExport(
// Add an optional importObject:
// {
// global: {},
// env: {},
// }
);

console.log(main() === 3); // true
} catch (err) {
console.error(err);
}
})();
`

$3


file.wasm

`

`

test.js

`js
import wasmModulePreprocessor from 'wasm-module-preprocessor';
import { readFileSync } from 'fs';
import { runInNewContext } from 'vm';

const bufferSource = readFileSync('file.wasm');

const wasmModuleExportString = wasmModulePreprocessor(
bufferSource,
// Only use this for small wasm modules. The max size of the
// binary will, by default, be restricted to less than 4KiB.
{ sync: true },
);

const wasmModuleExport = runInNewContext((() => ${wasmModuleExportString})());

const {
exports: {
main = () => undefined,
},
} = wasmModuleExport(
// Add an optional importObject:
// {
// global: {},
// env: {},
// }
);

console.log(main() === 3); // true
`

Documentation

$3

bufferSource | Default:*

* options