wabt.js

JavaScript version of WABT, the WebAssembly Binary Toolkit.

Usage

$> npm install wabt

var wabt = require("wabt");

var wasm = ...; // a buffer holding the contents of a wasm file

var myModule = wabt.readWasm(wasm, { readDebugNames: true });
myModule.applyNames();

var wast = myModule.toText({ foldExprs: false, inlineExport: false });

console.log(wast);

API

• parseWast(filename: string, buffer: string | Uint8Array): WasmModule
  Parses a wast source to a module.

• readWasm(buffer: Uint8Array, options: IReadWasmOptions): WasmModule
  Reads a wasm binaryen to a module.

• WasmModule
  A class representing a WebAssembly module.

  • generateNames(): void
    Generates textual names for function types, globals, labels etc.
  • applyNames(): void
    Applies textual names.
  • toText(options: IToTextOptions): string
    Converts the module to wast text format.
  • toBinary(options: IToBinaryOptions): IToBinaryResult
    Converts the module to a wasm binary.
  • destroy(): void
    Disposes the module and frees its resources.

• IReadWasmOptions
  Options modifying the behavior of readWasm.

  • readDebugNames: boolean
    Reads textual names from the name section.

• IToTextOptions
  Options modifying the behavior of WasmModule#toText.

  • foldExprs: boolean
  • inlineExport: boolean

• IToBinaryOptions
  Options modifying the behavior of WasmModule#toBinary.

  • log: boolean
  • canonicalize_lebs: boolean
  • relocatable: boolean
  • write_debug_names: boolean

• IToBinaryResult
  Result object of WasmModule#toBinary.

  • buffer: Uint8Array
    The wasm binary buffer.

  • log: string
    Generated log output.