GiavaScript

GiavaScript is an open-source, cross-platform JavaScript runtime implemented in Crystal.

It intentionally does not aim for full ECMAScript compliance. Check the reference docs before relying on specific language features.

• Crystal 1.19.1 or later

git clone https://github.com/memburg/GiavaScript.git
cd GiavaScript
crystal run src/giavascript_cli.cr -- install.js

This installs the giavascript binary and a gs shortcut (symlink) to /usr/local/bin by default. Both commands work interchangeably.

Install to a user-local path instead of /usr/local/bin:

INSTALL_DIR="$HOME/.local/bin" crystal run src/giavascript_cli.cr -- install.js

Make sure your install directory is on PATH.

gs

REPL commands:

• :quit exits the REPL.

gs path/to/program.js

Behavior to expect:

• Empty files return an error.
• If a runtime error occurs, messages are written to standard error.
• Process exit code is 1 when any Error: message is produced; otherwise 0.

crystal run src/giavascript_cli.cr -- examples/templateLiterals.js

Run the tests:

crystal spec

• Language features
• Type methods and properties
• Math
• JSON

Sample programs are in examples/:

• examples/templateLiterals.js - string interpolation and expression formatting
• examples/arrayFlatFlatMapSplice.js - array manipulation methods
• examples/dateBasics.js - Date object usage
• examples/functionExpressionsAndOperators.js - function expressions and operators
• examples/multilineMethodChaining.js - method chaining patterns
• examples/objectKeysValuesEntries.js - Object.keys, values, entries
• examples/random.js - random number generation
• examples/tryCatchFinally.js - error handling with try/catch/finally

Run any example with:

gs examples/templateLiterals.js

See CONTRIBUTING.md for setup, test, and documentation update guidelines.