Skip to content
/ boa Public

Boa is an embeddable and experimental Javascript engine written in Rust. Currently, it has support for some of the language.

License

MIT, Unlicense licenses found

Licenses found

MIT
LICENSE-MIT
Unlicense
LICENSE-UNLICENSE
Notifications You must be signed in to change notification settings

boa-dev/boa

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

27c2c1c · Jan 5, 2024
Oct 25, 2022
Dec 6, 2023
Dec 6, 2023
Mar 18, 2020
Dec 29, 2023
Jan 5, 2024
Dec 3, 2023
Jan 1, 2024
Dec 6, 2023
Jan 3, 2024
Aug 27, 2020
Aug 27, 2020
Dec 6, 2023
Dec 6, 2023
Sep 5, 2023
Jul 5, 2023
Oct 26, 2022
Oct 15, 2023
Jan 3, 2024
Jan 3, 2024
Jul 11, 2019
Jul 11, 2019
Aug 1, 2023
Mar 25, 2023
Feb 3, 2022
Jul 5, 2023
Dec 6, 2023
Dec 29, 2023
Dec 29, 2023
Dec 6, 2023
Dec 6, 2023

Boa

Boa Logo

This is an experimental Javascript lexer, parser and interpreter written in Rust. Currently, it has support for some of the language.

Build Status codecov Crates.io Docs.rs Discord

Live Demo (WASM)

https://boajs.dev/boa/playground/

You can get more verbose errors when running from the command line.

Conformance

To know how much of the ECMAScript specification does Boa cover, you can check out results running the ECMASCript Test262 test suite here.

Contributing

Please, check the CONTRIBUTING.md file to know how to contribute in the project. You will need Rust installed and an editor. We have some configurations ready for VSCode.

Debugging

Check debugging.md for more info on debugging.

Web Assembly

This interpreter can be exposed to JavaScript! You can build the example locally with:

npm run build

In the console you can use window.evaluate to pass JavaScript in. To develop on the web assembly side you can run:

npm run serve

then go to http://localhost:8080.

Usage

  • Clone this repo.
  • Run with cargo run -- test.js in the project root directory where test.js is a path to an existing JS file with any valid JS code.
  • If any JS doesn't work then it's a bug. Please raise an issue!

Example

Example

Command-line Options

Usage: boa [OPTIONS] [FILE]...

Arguments:
  [FILE]...  The JavaScript file(s) to be evaluated

Options:
      --strict                        Run in strict mode
  -a, --dump-ast [<FORMAT>]           Dump the AST to stdout with the given format [possible values: debug, json, json-pretty]
  -t, --trace                         Dump the AST to stdout with the given format
      --vi                            Use vi mode in the REPL
  -O, --optimize
      --optimizer-statistics
      --flowgraph [<FORMAT>]          Generate instruction flowgraph. Default is Graphviz [possible values: graphviz, mermaid]
      --flowgraph-direction <FORMAT>  Specifies the direction of the flowgraph. Default is top-top-bottom [possible values: top-to-bottom, bottom-to-top, left-to-right, right-to-left]
      --debug-object                  Inject debugging object `$boa`
  -m, --module                        Treats the input files as modules
  -r, --root <ROOT>                   Root path from where the module resolver will try to load the modules [default: .]
  -h, --help                          Print help (see more with '--help')
  -V, --version                       Print version

Roadmap

See Milestones.

Benchmarks

See Benchmarks.

Profiling

See Profiling.

Changelog

See CHANGELOG.md.

Communication

Feel free to contact us on Discord.

License

This project is licensed under the Unlicense or MIT licenses, at your option.