WasmSuperGlue

A minimal JavaScript-WebAssembly interface.

Examples

First step:

// JavaScript
const app = new WasmApp('app.wasm');
await app.init();

Create an array of 100 32-bit integers shared with both JavaScript and WebAssembly:

// JavaScript
app.arrays.myArray = app.newArray(100, 'i32');

Pass the array to your Wasm "i32Fill" function, which fills it with the number 1337:

// JavaScript
app.functions.i32Fill(app.arrays.myArray.pointer, app.arrays.myArray.length, 1337);

// C++
// define cute type aliases =)
typedef long int i32;
typedef long long int i64;
typedef float f32;
typedef double f64;

// The asterisk before array (*array) means it's the location (pointer) of the first index of the array inside Wasm memory.
void i32Fill(i32 *array, int length, i32 value) {
  for (int i = 0; i < length; i++) { 
    array[i] = value;
  }
}

Set the first value of the same array to 2003, in JavaScript:

// JavaScript
app.arrays.myArray[0] = 2003; // Always access your arrays this way, via the .arrays property

Pass a number to Wasm to perform a custom compiled calculation and recieve the result:

// JavaScript
const myNumber = app.functions.f64myCustomFunction(100);
console.log(myNumber); // 200.75075075075074

// C++
f64 f64myCustomFunction(f64 number) {
  return number * 1337 / 666;
}