DEV Community

Cover image for Compile Go to WebAssembly (the browser version)
Dorin
Dorin

Posted on • Originally published at fodor.org

13 7

Compile Go to WebAssembly (the browser version)

Introduction

I don't think many people realised yet the great possibilities we were given with the advent of WebAssembly.

We are now essentially able to compile almost any (see list) language to WebAssembly. Which means that the range of applications that we can run in a browser, on the client side, has grown exponentially!

For example, I would like to show you below how you can take your Go code, compile it to WebAssembly and run it natively in the browser.

🍖 & 🥔

Let's to this step by step!

  1. Prepare a Go application that you want to convert to WebAssembly. NOte that you can only compile main packages. If your code is not part of a main package then make it so.

    Here is what I am going to compile:

    package main
    
    import "fmt"
    
    func main() {
        fmt.Println("Hello world!")
    }
    

    Classic.

  2. Run the go command to compile your Go code to WASM.

    GOOS=js GOARCH=wasm go build -o main.wasm
    
  3. Copy the glue JS file which will let you execute the compiled WASM in the browser. This is a file located inside your $GOROOT directory.

    cp "$(go env GOROOT)/misc/wasm/wasm_exec.js" .
    
  4. Create a HTML file with the following contents. Note that we are including the wasm.exec.js file that we just copied.

    <html>
        <head>
            <meta charset="utf-8"/>
            <script src="wasm_exec.js"></script>
            <script>
                const go = new Go();
    
    WebAssembly.instantiateStreaming(fetch("main.wasm"), 
    go.importObject).then((result) => {
                    go.run(result.instance);
                });
            </script>
        </head>
        <body></body>
    </html>
    
  5. Now you have to spin up a local web server and load the HTML file through it. If you're not sure how to do this, there is a quick way to do it with Go. Just execute the following two commands in the terminal.

    go get -u github.com/shurcooL/goexec
    goexec 'http.ListenAndServe(`:8080`, http.FileServer(http.Dir(`.`)))'
    

If everything went well you'll be able to navigate to localhost:8080 and be presented with a blank page. Now open the developer tools and check the console!

Great success!

Automating the process

I have also put together a little script which lets you compile and start the server in one command.

Check out the repository below.

GitHub logo dorin131 / go-to-webassembly

Compile Go to WebAssembly

go-to-webassembly

  1. Write your WebAssembly code into the main function of main.go
  2. Run ./compile.sh
  3. Open URL localhost:8080 and check the console for output



By running compile.sh, all the steps above are going to be executed.

Video

Image of Timescale

🚀 pgai Vectorizer: SQLAlchemy and LiteLLM Make Vector Search Simple

We built pgai Vectorizer to simplify embedding management for AI applications—without needing a separate database or complex infrastructure. Since launch, developers have created over 3,000 vectorizers on Timescale Cloud, with many more self-hosted.

Read full post →

Top comments (0)

Billboard image

The Next Generation Developer Platform

Coherence is the first Platform-as-a-Service you can control. Unlike "black-box" platforms that are opinionated about the infra you can deploy, Coherence is powered by CNC, the open-source IaC framework, which offers limitless customization.

Learn more