Skip to content

pombredanne/gopherjs

 
 

Repository files navigation

GopherJS - A transpiler from Go to JavaScript

Build Status

GopherJS translates Go code (golang.org) to pure JavaScript code. Its main purpose is to give you the opportunity to write front-end code in Go which will still run in all browsers. Give GopherJS a try on the GopherJS Playground.

You can take advantage of Go's elegant type system and other compile-time checks that can have a huge impact on bug detection and the ability to refactor, especially for big projects. Just think of how often a JavaScript method has extra handling of some legacy parameter scheme, because you don't know exactly if some other code is still calling it in that old way or not. GopherJS will tell you and if it does not complain, you can be sure that this kind of bug is not present any more.

Design Goals

What is supported?

In one sentence: Everything except goroutines. Yes, I know that you want goroutines and I am working heavily on them. But hey, it is still better to write Go with callbacks than JavaScript with callbacks, right? A lot of Go's packages do already work, see the compatibility table. If you want this still missing feature, please consider to support this project with a star to show your interest.

Installation and Usage

Get or update GopherJS and dependencies with:

go get -u github.com/gopherjs/gopherjs

Now you can use ./bin/gopherjs build [files] or ./bin/gopherjs install [package] which behave similar to the go tool. For main packages, these commands create a .js file and .js.map source map in the current directory or in $GOPATH/bin. The generated JavaScript file can be used as usual in a website. Go's println builtin prints to the JavaScript console via console.log. If you want to run the generated code with Node.js, see this page.

Note: GopherJS will try to write compiled object files of the core packages to your $GOROOT/pkg directory. If that fails, it will fall back to $GOPATH/pkg.

Getting started

Take a look at Jason Stone's blog post about GopherJS.

Interface to native JavaScript

The package github.com/gopherjs/gopherjs/js provides functions for interacting with native JavaScript APIs. Please see its documentation for further details.

Community

Roadmap

These features are not implemented yet, but on the roadmap:

  • goroutines, channels, select
  • output minification
  • float32 and complex64 currently have the same precision as float64 and complex128

About

A transpiler from Go (golang.org) to JavaScript for running Go code in a browser

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published