How dop251/goja works
Goja is a pure-Go ECMAScript engine: a Go host supplies JavaScript source and values, the front end parses and compiles programs, and the runtime executes them and returns values or errors. The runtime also provides ECMAScript objects and built-ins, plus conversion between Go and JavaScript values. The README documents source maps and host-controlled integrations; sampled excerpts do not establish all internal wiring, so uncertain links are omitted.
Main entry points: runtime.go Runtime API · parser.go Parser · builtin_global.go ECMAScript built-ins · vm.go Virtual machine
Components 16
Parsing and compilation
- Parser
parser/parser.go - AST
ast/node.go - Source positions
file/file.go - Compiler
compiler.go
Runtime execution
- Runtime API
runtime.go - Virtual machine
vm.go
JavaScript values
- Values
value.go - Objects
object.go - ECMAScript built-ins
builtin_global.go - Regular expressions
regexp.go - Date handling
date.go - String representation
unistring/string.go
Host integration
- Go value conversion
object_goreflect.go - Source maps
file/file.go - Command-line runner
goja/main.go
Other components
- Go host
Connections 19
- Go host → Runtime API: creates and calls
- Go host → Go value conversion: supplies values
- Runtime API → Compiler: compiles source
- Compiler → Parser: parses source
- Parser → AST: builds AST
- Parser → Source positions: records positions
- Compiler → Virtual machine: produces program
- Runtime API → Virtual machine: runs program
- Runtime API → ECMAScript built-ins: initializes
- Virtual machine → Values: evaluates
- Virtual machine → Objects: operates on
- ECMAScript built-ins → Objects: uses
- ECMAScript built-ins → Regular expressions: provides regex
- ECMAScript built-ins → Date handling: provides dates
- Values → String representation: represents strings
- Runtime API → Go value conversion: converts values
- Parser → Source maps: loads mappings
- Command-line runner → Runtime API: runs scripts
- Command-line runner → Go host: reads source