Skip to main content

Run Standalone

Now, let's run wasm standalone.
Before to run, prepare wasm program built for standalone.

  • prime_standalone.wasm : wasm file built for standalone

or

  • print_prime_standalone.wasm : wasm file built for standalone (this is mainly made for wavm runtime)

File name may differs depending on the languages.

wasmtime​

wasmtime is standalone runtime for WebAssembly. Executable file can be downloaded from github releases.

Command line options can be found at CLI Options for wasmtime.
This command invokes the prime() function.

invoke prime function with wasmtime
wasmtime run prime_standalone.wasm --invoke prime 10000
output
warning: using `--invoke` with a function that takes arguments is experimental and may break in the future
warning: using `--invoke` with a function that returns values is experimental and may break in the future
9973

wasmer​

wasmer is also a famous standalone runtime for WebAssembly. Executable files can be downloaded at github releases.

Command line options can be found at CLI Usage.
This command invokes the prime() function.

invoke prime function with wasmer
wasmer run --invoke prime prime_standalone.wasm -- 10000
output
9973

wasm3​

wasm3 is an interpreter for WebAssembly. Executable files can be downloaded at github releases.

wasm3 options can be found by the command wasm3 --help.
This command invokes the prime() function.

invoke prime function with wasm3
wasm3 --func prime prime_standalone.wasm 10000
output
Result: 9973

Deno​

Deno is also a runtime for WebAssembly which uses V8.
Executable files can be downloaded at github releases.

First, we need to write a typescript to call functions.

Deno.ts
const wasmCode = await Deno.readFile("./prime_standalone.wasm");
const wasmModule = new WebAssembly.Module(wasmCode);
const wasmInstance = new WebAssembly.Instance(wasmModule);
const prime = wasmInstance.exports.prime as CallableFunction;

let n = +Deno.args[Deno.args.length - 1];

let startTime = performance.now();
let maxPrime = prime(n);
let endTime = performance.now();

console.log("given number =", n);
console.log("max prime =", maxPrime);
console.log("duration [ms] =", (endTime - startTime).toFixed(2));

Then, run the command as follows.
More command line options can be found at Command line interface.

invoke prime function with Deno
deno run --allow-read deno.ts -- 10000
output
given number = 10000
max prime = 9973
duration [ms] = 2.00

Bun​

Bun is a fast JavaScript runtime tha can also run WebAssembly.
Executable files can be downloaded at github releases.

First, like deno, we need to write a typescript to call functions.

Bun.ts
import * as fs from "fs";

const wasmCode = fs.readFileSync("./prime_standalone.wasm");
const wasmModule = new WebAssembly.Module(wasmCode);
const wasmInstance = new WebAssembly.Instance(wasmModule);
const prime = wasmInstance.exports.prime as CallableFunction;

let n = +Bun.argv[Bun.argv.length - 1];

let startTime = performance.now();
let maxPrime = prime(n);
let endTime = performance.now();

console.log("given number =", n);
console.log("max prime =", maxPrime);
console.log("duration [ms] =", (endTime - startTime).toFixed(2));

Then run the script with the command

invoke prime function with Deno
bun run bun.ts -- 10000

The output will be

output
given number = 10000
max prime = 9973
duration [ms] = 9.29

wasmi​

wasmi is an interpreter of WebAssembly written in Rust.
We have to build wasmi_cli from source code because executable file is not distributed.

This is the command to invoke prime() function with wasme_cli.

invoke prime function with wasmi
wasmi_cli prime_standalone.wasm prime 10000
output
executing prime.wasm::prime(10000) ...
9973

More options can be seen with wasmi_cli --help or wasmi_cli run --help.

WAVM​

WAVM (WebAssembly Virtual Machine) is also a well known runtime for WebAssembly.
Executable files can be downloaded at github releases.

Unlike other runtime, WAVM does not print the returned value.
So, print function should be in the source code to see the calculated result.
Some sample program (not all) contain function named print_prime for the purpose of this situation.

So, lets use print_prime.wasm here.

This command invoke print_prime function and show the calculate result.

invoke print_prime function with WAVM
wavm run --function=print_prime print_prime_standalone.wasm 10000
output
max prime = 9973

More options can be seen with wavm --help or wavm run --help.