raskad
9f0ac30082
|
2 years ago | |
---|---|---|
.github | 2 years ago | |
.vscode | 3 years ago | |
assets | 5 years ago | |
boa_cli | 2 years ago | |
boa_engine | 2 years ago | |
boa_examples | 2 years ago | |
boa_gc | 2 years ago | |
boa_interner | 2 years ago | |
boa_profiler | 2 years ago | |
boa_tester | 2 years ago | |
boa_unicode | 2 years ago | |
boa_wasm | 2 years ago | |
docs | 3 years ago | |
test262@9215420dee | 2 years ago | |
.editorconfig | 4 years ago | |
.gitattributes | 4 years ago | |
.gitignore | 3 years ago | |
.gitmodules | 4 years ago | |
.prettierignore | 3 years ago | |
CHANGELOG.md | 2 years ago | |
CODE_OF_CONDUCT.md | 4 years ago | |
CONTRIBUTING.md | 3 years ago | |
Cargo.lock | 2 years ago | |
Cargo.toml | 2 years ago | |
LICENSE-MIT | 5 years ago | |
LICENSE-UNLICENSE | 5 years ago | |
README.md | 2 years ago | |
bors.toml | 3 years ago | |
clippy.toml | 3 years ago | |
index.html | 3 years ago | |
index.js | 3 years ago | |
package-lock.json | 2 years ago | |
package.json | 2 years ago | |
test_ignore.txt | 2 years ago | |
webpack.config.js | 3 years ago |
README.md
Boa
This is an experimental Javascript lexer, parser and interpreter written in Rust. Currently, it has support for some of the language.
Live Demo (WASM)
https://boa-dev.github.io/boa/playground/
You can get more verbose errors when running from the command line.
Development documentation
You can check the internal development docs at https://boa-dev.github.io/boa/doc.
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
wheretest.js
is an existing JS file with any JS valid code. - If any JS doesn't work then it's a bug. Please raise an issue!
Example
Command-line Options
USAGE:
boa [OPTIONS] [FILE]...
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-a, --dump-ast <FORMAT> Dump the abstract syntax tree (ast) to stdout with the given format [possible values: Debug, Json,
JsonPretty]
ARGS:
<FILE>... The JavaScript file(s) to be evaluated
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.