Javy - Wazero example

There are currently 2 flavors of Javy:

• Shopify's original version: Only accepts input via stdin and only produces output via stdout
• Suborbital's fork: Reads and writes to memory (exports allocate and deallocate)

This repository provides an example written for both versions

• Shopify Javy
• Suborbital Javy

Why Javy?

On the surface, it might seem quite strange to have a compiler that compiles JavaScript to WebAssembly, given that we can execute JavaScript directly in the browser and Node.js. However, Javy unlocks interesting use-cases for running JavaScript libraries in any WebAssembly environment.

As an example, to compile MJML into HTML, one would need to use the MJML library, which is written in JavaScript. By writing a thin wrapper around the library and compiling it into WebAssembly using Javy, we can now embed the WebAssembly module in any application that has a WebAssembly runtime. We recently released mjml-go which does exactly this. Please check it out to see how to use Wazero beyond the simple examples in this repository.

Why Wazero?

Wazero is a pure-Go WebAssembly runtime. It does not require CGO nor does it need any external dependencies. Another benefit is that the API is well-though-out and easy to grok.

Benchmarks

To run the benchmarks, run go test -bench=. ./... from the root of the repository.

Here are the results on my machine:

goos: darwin
goarch: arm64
pkg: github.com/F21/javy-wazero/shopify-javy
BenchmarkShopifyInstantiateModule-12    	    3548	    333316 ns/op
PASS
ok  	github.com/F21/javy-wazero/shopify-javy	2.438s
goos: darwin
goarch: arm64
pkg: github.com/F21/javy-wazero/suborbital-javy
BenchmarkSuborbitalCallFunction-12    	   26733	     44817 ns/op
PASS
ok  	github.com/F21/javy-wazero/suborbital-javy	2.835s