docs.sheetjs.com/docz/docs/03-demos/42-engines/06-goja.md

---
title: Sheets in Golang with Goja
sidebar_label: Go + Goja
pagination_prev: demos/bigdata/index
pagination_next: solutions/input
---

import current from '/version.js';
import CodeBlock from '@theme/CodeBlock';

Goja[^1] is a pure Go implementation of ECMAScript 5.

[SheetJS](https://sheetjs.com) is a JavaScript library for reading and writing
data from spreadsheets.

This demo uses Goja and SheetJS to read and write spreadsheets. We'll explore
how to load SheetJS in the Goja engine, exchange binary data with a Go program
and process spreadsheets and structured data.

The ["Complete Example"](#complete-example) section makes a command-line tool
for reading arbitrary workbooks and writing data to XLSB workbooks.

## Integration Details

The [SheetJS Standalone scripts](/docs/getting-started/installation/standalone)
can be parsed and evaluated in a Goja context.

### Initialize Goja

Goja does not provide a `global` variable. It can be created in one line:

```go
/* initialize */
vm := goja.New()

/* goja does not expose a standard "global" by default */
// highlight-next-line
v, err := vm.RunString("var global = (function(){ return this; }).call(null);")
```

### Load SheetJS Scripts

The shim and main libraries can be loaded by reading the scripts from the file
system and evaluating in the Goja context:

```go
func safe_run_file(vm *goja.Runtime, file string) {
  data, err := ioutil.ReadFile(file)
  if err != nil { panic(err) }
  src := string(data)
  _, err = vm.RunString(src)
  if err != nil { panic(err) }
}

// ...
  safe_run_file(vm, "shim.min.js")
  safe_run_file(vm, "xlsx.full.min.js")
```

To confirm the library is loaded, `XLSX.version` can be inspected:

```go
  /* get version string */
  v, err := vm.RunString("XLSX.version")
  fmt.Printf("SheetJS library version %s\n", v)
```

### Reading Files

Files can be read into `[]byte`:

```go
/* read file */
data, _ := ioutil.ReadFile("sheetjs.xlsx")
```

`[]byte` should be converted to an `ArrayBuffer` from Go:

```go
/* load into engine */
vm.Set("buf", vm.ToValue(vm.NewArrayBuffer(data)))

/* parse */
wb, _ = vm.RunString("wb = XLSX.read(buf, {type:'buffer'});")
```

### Writing Files

`"base64"` strings can be passed from the JS context to Go code:

```go
/* write to Base64 string */
b64str, _ := vm.RunString("XLSX.write(wb, {type:'base64', bookType:'xlsx'})")

/* pull data back into Go and write to file */
buf, _ := base64.StdEncoding.DecodeString(b64str.String())
_ = ioutil.WriteFile("sheetjs.xlsx", buf, 0644)
```

## Complete Example

:::note Tested Deployments

This demo was tested in the following deployments:

| Architecture | Git Commit | Go version | Date       |
|:-------------|:-----------|:-----------|:-----------|
| `darwin-x64` | `bcd7cc6`  | `1.24.1`   | 2025-03-31 |
| `darwin-arm` | `cb187b0`  | `1.24.0`   | 2025-06-18 |
| `win11-x64`  | `bcd7cc6`  | `1.24.2`   | 2025-04-28 |
| `win11-arm`  | `5ef83b8`  | `1.24.0`   | 2025-02-23 |
| `linux-x64`  | `cb187b0`  | `1.22.2`   | 2025-06-16 |
| `linux-arm`  | `5ef83b8`  | `1.19.8`   | 2025-02-15 |

At the time of writing, Goja did not have proper version numbers. Versions are
identified by Git commit hashes.

:::

0) Create a module and install dependencies:

```bash
mkdir SheetGoja
cd SheetGoja
go mod init SheetGoja
go get github.com/dop251/goja
```

1) Download the SheetJS Standalone script, shim script and test file. Move all
three files to the project directory:

<ul>
<li><a href={`https://cdn.sheetjs.com/xlsx-${current}/package/dist/xlsx.full.min.js`}>xlsx.full.min.js</a></li>
<li><a href={`https://cdn.sheetjs.com/xlsx-${current}/package/dist/shim.min.js`}>shim.min.js</a></li>
<li><a href="https://docs.sheetjs.com/pres.numbers">pres.numbers</a></li>
</ul>

<CodeBlock language="bash">{`\
curl -LO https://cdn.sheetjs.com/xlsx-${current}/package/dist/shim.min.js
curl -LO https://cdn.sheetjs.com/xlsx-${current}/package/dist/xlsx.full.min.js
curl -LO https://docs.sheetjs.com/pres.numbers`}
</CodeBlock>

:::caution pass

PowerShell `curl` is incompatible with the official `curl` program. The command
may fail with a parameter error:

```
Invoke-WebRequest : A parameter cannot be found that matches parameter name 'LO'.
```

`curl.exe` must be used instead:

<CodeBlock language="bash">{`\
curl.exe -LO https://cdn.sheetjs.com/xlsx-${current}/package/dist/shim.min.js
curl.exe -LO https://cdn.sheetjs.com/xlsx-${current}/package/dist/xlsx.full.min.js
curl.exe -LO https://docs.sheetjs.com/pres.numbers`}
</CodeBlock>

:::

2) Download [`SheetGoja.go`](pathname:///goja/SheetGoja.go):

```bash
curl -LO https://docs.sheetjs.com/goja/SheetGoja.go
```

:::caution pass

PowerShell `curl` is incompatible with the official `curl` program. The command
may fail with a parameter error:

```
Invoke-WebRequest : A parameter cannot be found that matches parameter name 'LO'.
```

`curl.exe` must be used instead:

```bash
curl.exe -LO https://docs.sheetjs.com/goja/SheetGoja.go
```

:::

3) Build the standalone `SheetGoja` binary:

```bash
go build SheetGoja.go
```

4) Run the demo:

```bash
./SheetGoja pres.numbers
```

If the program succeeded, the CSV contents will be printed to console and the
file `sheetjsw.xlsb` will be created.  That file can be opened with Excel.

[^1]: The project does not have a website. The library is hosted on [GitHub](https://pkg.go.dev/github.com/dop251/goja).