wasm-json-toolkit

this convertes wasm binaries to json and json to wasm binaries

Usage no npm install needed!

<script type="module">
  import wasmJsonToolkit from 'https://cdn.skypack.dev/wasm-json-toolkit';
</script>

README

SYNOPSIS

NPM Package Build Status Coverage Status

js-standard-style

A small toolkit for converting wasm binaries into json and back.

INSTALL

npm install wasm-json-toolkit

USAGE

const fs = require('fs')
const wasm2json = require('wasm-json-toolkit').wasm2json

const wasm = fs.readFileSync('./test.wasm')
const json = wasm2json(wasm)

console.log(JSON.stringify(json, null, 2))

CLI

Install -g global for cli usage.

wasm2json [FILE] given a file containing a wasm module produces a json representation
json2wasm [FILE] given a file containing a json representation produces a wasm module

API

wasm2json

converts a wasm binary into a json representation

Parameters

  • Buffer - The Webassembly Binary
  • filter - Set containing the name of sections to parse. If no filter is given all sections will be parsed

Returns Object

json2wasm

converts a json representation to a wasm binary

Parameters

  • Object

Returns Buffer

text2json

converts text to json. The only text accepted is a simple list of opcode name and immediates

Parameters

  • String

Examples

const codeStr = `
i64.const 1
i64.const 2
i64.add
`
const json = text2json(codeStr)

Returns Object

iterator

iterator.js:12-58

The Module Iterator allows for iteration over a webassembly module's sections. A section is wrapped in a section class. A section class instance allows you append entries to a given section

Examples

const it = new Iterator(wasm)
for (const section of it) {
  console.log(section.type)
  const json = section.toJSON()
}

wasm

iterator.js:26-32

if the orignal wasm module was modified then this will return the modified wasm module

iterator

iterator.js:38-52

Iterates through the module's sections return {Iterator.

}

Section

iterator.js:64-110

The section class is always internal created by the Module class. And return through the Module's iternator

toJSON

iterator.js:83-85

Parses the section and return the JSON repesentation of it returns {Object}

appendEntries

iterator.js:92-109

Appends an array of entries to this section. NOTE: this will modify the parent wasm module.

Parameters

exammple json output

wast

(module
  (func $addTwo (param i32 i32) (result i32)
    (i32.add
      (get_local 0)
      (get_local 1)))
  (export "addTwo" (func $addTwo)))

wasm

0x010661646454776f00000a09010700200020016a0b

json

[
  {
    "name": "preramble",
    "magic": [0,97,115,109],
    "version": [13,0,0,0]
  },
  {
    "name": "type",
    "entries": [
      {
        "form": "func",
        "params": ["i32","i32"],
        "return_type": "i32"
      }
    ]
  },
  {
    "name": "function",
    "entries": [0]
  },
  {
    "name": "export",
    "entries": [
      {
        "field_str": "addTwo",
        "kind": "Function",
        "index": 0
      }
    ]
  },
  {
    "name": "code",
    "entries": [
      {
        "locals": [],
        "code": [
          {
            "name": "get_local",
            "immediaties": "0"
          },
          {
            "name": "get_local",
            "immediaties": "1"
          },
          {
            "return_type": "i32",
            "name": "add"
          },
          {
            "name": "end"
          }
        ]
      }
    ]
  }
]

LICENSE

MPL-2.0