jsre

Documentation

Overview

Package jsre provides execution environment for JavaScript.

Index

• type JSRE
  • func New(assetPath string, output io.Writer) *JSRE
  • func (self *JSRE) Bind(name string, v interface{}) error
  • func (self *JSRE) Compile(filename string, src interface{}) (err error)
  • func (jsre *JSRE) CompleteKeywords(line string) []string
  • func (self *JSRE) Do(fn func(*otto.Otto))
  • func (self *JSRE) Evaluate(code string, w io.Writer) error
  • func (self *JSRE) Exec(file string) error
  • func (self *JSRE) Get(ns string) (v otto.Value, err error)
  • func (self *JSRE) Run(code string) (v otto.Value, err error)
  • func (self *JSRE) Set(ns string, v interface{}) (err error)
  • func (self *JSRE) Stop(waitForCallbacks bool)

Types

type JSRE

type JSRE struct {
	// contains filtered or unexported fields
}

JSRE is a generic JS runtime environment embedding the otto JS interpreter. It provides some helper functions to - load code from files - run code snippets - require libraries - bind native go objects

func New

func New(assetPath string, output io.Writer) *JSRE

runtime must be stopped with Stop() after use and cannot be used after stopping

func (*JSRE) Bind

func (self *JSRE) Bind(name string, v interface{}) error

Bind assigns value v to a variable in the JS environment This method is deprecated, use Set.

func (*JSRE) Compile

func (self *JSRE) Compile(filename string, src interface{}) (err error)

Compile compiles and then runs a piece of JS code.

func (*JSRE) CompleteKeywords

func (jsre *JSRE) CompleteKeywords(line string) []string

CompleteKeywords returns potential continuations for the given line. Since line is evaluated, callers need to make sure that evaluating line does not have side effects.

func (*JSRE) Do

func (self *JSRE) Do(fn func(*otto.Otto))

Do executes the given function on the JS event loop.

func (*JSRE) Evaluate

func (self *JSRE) Evaluate(code string, w io.Writer) error

Evaluate executes code and pretty prints the result to the specified output stream.

func (*JSRE) Exec

func (self *JSRE) Exec(file string) error

Exec(file) loads and runs the contents of a file if a relative path is given, the jsre's assetPath is used

func (*JSRE) Get

func (self *JSRE) Get(ns string) (v otto.Value, err error)

Get returns the value of a variable in the JS environment.

func (*JSRE) Run

func (self *JSRE) Run(code string) (v otto.Value, err error)

Run runs a piece of JS code.

func (*JSRE) Set

func (self *JSRE) Set(ns string, v interface{}) (err error)

Set assigns value v to a variable in the JS environment.

func (*JSRE) Stop

func (self *JSRE) Stop(waitForCallbacks bool)

stops the event loop before exit, optionally waits for all timers to expire