Documentation
¶
Overview ¶
Package js provides functions for interacting with native JavaScript APIs. Calls to these functions are treated specially by GopherJS and translated directly to their corresponding JavaScript syntax.
Type conversions between Go types and JavaScript types are performed automatically according to the following table:
| Go type | Conversions to interface{} | JavaScript type |
| ------------------------------ | ------------------------------ | ----------------- |
| bool | bool | Boolean |
| int?, uint?, float? | float64 | Number |
| string | string | String |
| [?]int8 | []int8 | Int8Array |
| [?]int16 | []int16 | Int16Array |
| [?]int32, [?]int | []int | Int32Array |
| [?]uint8 | []uint8 | Uint8Array |
| [?]uint16 | []uint16 | Uint16Array |
| [?]uint32, [?]uint, [?]uintptr | []uint | Uint32Array |
| [?]float32 | []float32 | Float32Array |
| [?]float64 | []float64 | Float64Array |
| all other slices and arrays | []interface{} | Array |
| functions | func(...interface{}) js.Object | Function |
| time.Time | time.Time | Date |
| - | js.Object | instanceof Node |
| maps, structs | map[string]interface{} | instanceof Object |
Additionally, for a struct containing a js.Object field, only the content of the field will be passed to JavaScript and vice versa.
Index ¶
Constants ¶
This section is empty.
Variables ¶
var Arguments []Object
Arguments gives the value of JavaScript's "arguments" keyword. It can be used when passing Go functions to JavaScript as callbacks. Set this to a mock for testing with pure Go.
Functions ¶
Types ¶
type Error ¶
type Error struct {
Object
}
Error encapsulates JavaScript errors. Those are turned into a Go panic and may be rescued, giving an *Error that holds the JavaScript error object.
type M ¶
type M map[string]interface{}
M is a simple map type. It is intended as a shorthand for JavaScript objects (before conversion).
type Object ¶
type Object interface {
// Get returns the object's property with the given key.
Get(key string) Object
// Set assigns the value to the object's property with the given key.
Set(key string, value interface{})
// Delete removes the object's property with the given key.
Delete(key string)
// Get returns the object's "length" property, converted to int.
Length() int
// Index returns the i'th element of an array.
Index(i int) Object
// SetIndex sets the i'th element of an array.
SetIndex(i int, value interface{})
// Call calls the object's method with the given name.
Call(name string, args ...interface{}) Object
// Invoke calls the object itself. This will fail if it is not a function.
Invoke(args ...interface{}) Object
// New creates a new instance of this type object. This will fail if it not a function (constructor).
New(args ...interface{}) Object
// Bool returns the object converted to bool according to JavaScript type conversions.
Bool() bool
// String returns the object converted to string according to JavaScript type conversions.
String() string
// Int returns the object converted to int according to JavaScript type conversions (parseInt).
Int() int
// Int64 returns the object converted to int64 according to JavaScript type conversions (parseInt).
Int64() int64
// Uint64 returns the object converted to uint64 according to JavaScript type conversions (parseInt).
Uint64() uint64
// Float returns the object converted to float64 according to JavaScript type conversions (parseFloat).
Float() float64
// Interface returns the object converted to interface{}. See GopherJS' README for details.
Interface() interface{}
// Unsafe returns the object as an uintptr, which can be converted via unsafe.Pointer. Not intended for public use.
Unsafe() uintptr
}
Object is a container for a native JavaScript object. Calls to its methods are treated specially by GopherJS and translated directly to their JavaScript syntax. Nil is equal to JavaScript's "null". Object can not be used as a map key.
var Global Object
Global gives JavaScript's global object ("window" for browsers and "GLOBAL" for Node.js). Set this to a mock for testing with pure Go.
var Module Object
Module gives the value of the "module" variable set by Node.js. Hint: Set a module export with 'js.Module.Get("exports").Set("exportName", ...)'.
var This Object
This gives the value of JavaScript's "this" keyword. It can be used when passing Go functions to JavaScript as callbacks. Set this to a mock for testing with pure Go.
var Undefined Object
Undefined gives the JavaScript value "undefined".
func InternalObject ¶
func InternalObject(i interface{}) Object
InternalObject returns the internal JavaScript object that represents i. Not intended for public use.
func MakeWrapper ¶
func MakeWrapper(i interface{}) Object
MakeWrapper creates a JavaScript object which has wrappers for the exported methods of i. This can be used to provide getter and setter methods for Go fields to JavaScript.
func NewArrayBuffer ¶
NewArrayBuffer creates a JavaScript ArrayBuffer from a byte slice.
Source Files