wa-lang.org/wazero@v1.0.2/imports/go/README.md (about)

     1  # Overview
     2  
     3  When `GOOS=js` and `GOARCH=wasm`, Go's compiler targets WebAssembly Binary
     4  format (%.wasm).
     5  
     6  Wazero's "wa-lang.org/wazero/imports/go" package allows you to run
     7  a `%.wasm` file compiled by Go.  This is similar to what is implemented in
     8  [wasm_exec.js][1]. See https://wazero.io/languages/go/ for more.
     9  
    10  ## Example
    11  
    12  wazero includes an [example](example) that makes HTTP client requests.
    13  
    14  ## Experimental
    15  
    16  Go defines js "EXPERIMENTAL... exempt from the Go compatibility promise."
    17  Accordingly, wazero cannot guarantee this will work from release to release,
    18  or that usage will be relatively free of bugs. Due to this and the
    19  relatively high implementation overhead, most will choose TinyGo instead.
    20  
    21  [1]: https://github.com/golang/go/blob/go1.19/misc/wasm/wasm_exec.js