vert

README

vert

Package vert provides WebAssembly interop between Go and JS values.

Install

GOOS=js GOARCH=wasm go get github.com/norunners/vert

Examples

Hello World!

Below is a trivial string value interop.

package main

import "github.com/norunners/vert"

func main() {
	v := vert.ValueOf("Hello World!")
	// Use v as a JS value.

	s := ""
	v.AssignTo(&s)
	// Use s as a Go value.
}

Structs & Objects

Go structs and JS objects interop seamlessly.

package main

import "github.com/norunners/vert"

type Data struct {
	Message string
}

func main() {
	v := vert.ValueOf(Data{
		Message: "Hello World!",
	})
	// e.g. {"Message": "Hello World!"}

	d := &Data{}
	v.AssignTo(d)
}

Tagged Struct Fields

Tagged struct fields allow defined JS field names.

package main

import "github.com/norunners/vert"

type Data struct {
	Message string `js:"msg"`
}

func main() {
	v := vert.ValueOf(Data{
		Message: "Hello World!",
	})
	// The defined JS tag names the field.
	// e.g. {"msg": "Hello World!"}

	d := &Data{}
	v.AssignTo(d)
}

Error Handling

AssignTo returns an error value.

package main

import "github.com/norunners/vert"

type Data struct {
	Message string
}

func main() {
	v := vert.ValueOf("Hello World!")

	d := &Data{}
	if err := v.AssignTo(d); err != nil {
		// Handle error.
	}
}

Why?

Package syscall/js, of the Go standard library, has limited interop support between Go and JS values.

1. The function js.ValueOf will not accept struct types. The result panics with ValueOf: invalid value.
2. The type js.Value. does not support an Interface or assignment method for non-basic Go values. However, the methods Bool, Int, Float and String support basic Go values.

Package vert leverages and extends syscall/js to accommodate these shortcomings.

License

• MIT License

Documentation

Overview

Package vert provides WebAssembly interop between Go and JS values.

Index

• type InvalidAssignmentError
  • func (e *InvalidAssignmentError) Error() string
• type Value
  • func ValueOf(i interface{}) Value
  • func (v Value) AssignTo(i interface{}) error
  • func (v Value) JSValue() js.Value

Types

type InvalidAssignmentError

type InvalidAssignmentError struct {
	Type js.Type
	Kind reflect.Kind
	// contains filtered or unexported fields
}

func (*InvalidAssignmentError) Error

func (e *InvalidAssignmentError) Error() string

type Value

type Value struct {
	js.Value
}

Value is an assignable JS value.

func ValueOf

func ValueOf(i interface{}) Value

ValueOf returns the Go value as a new value.

func (Value) AssignTo

func (v Value) AssignTo(i interface{}) error

AssignTo assigns a JS value to a Go pointer. Returns an error on invalid assignments.

func (Value) JSValue

func (v Value) JSValue() js.Value

JSValue returns the JS value.