25493fe271
Before, our README said gojs `GOOS=js compiled wasm` was experimental. However, as we head to 1.0 we should be more explicit about that. When we started gojs, there was no likely future where `GOOS=wasi` would happen in the standard go compiler. This has changed, so we'll only keep the gojs package around until wasi is usable for two Go releases. Being in an experimental package helps others know to watch out for this. Signed-off-by: Adrian Cole <adrian@tetrate.io>
Overview
When GOOS=js and GOARCH=wasm, Go's compiler targets WebAssembly Binary
format (%.wasm).
Wazero's "github.com/tetratelabs/wazero/experimental/gojs" package allows you to run
a %.wasm file compiled by Go. This is similar to what is implemented in
wasm_exec.js. See https://wazero.io/languages/go/ for more.
Example
wazero includes an example that makes HTTP client requests.
Experimental
Go defines js "EXPERIMENTAL... exempt from the Go compatibility promise."
Accordingly, wazero cannot guarantee this will work from release to release,
or that usage will be relatively free of bugs. Moreover, [GOOS=wasi] will
happen, and once that's available in two releases wazero will remove this
package.
Due to these concerns and the relatively high implementation overhead, most will choose TinyGo instead of gojs.