Rust编写的JavaScript引擎,该项目是一个试验性质的项目。
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
dependabot[bot] 3cedb6dc00
Bump trybuild from 1.0.81 to 1.0.82 (#3161)
1 year ago
.config Cleanup and speed-up CI (#2376) 2 years ago
.github Bump benchmark-action/github-action-benchmark from 1.17.0 to 1.18.0 (#3125) 1 year ago
.vscode Unify async iterators and iterators compilation (#2976) 2 years ago
assets Added a logo to the project. (#277) 5 years ago
boa_ast Bump serde from 1.0.171 to 1.0.173 (#3156) 1 year ago
boa_cli Bump clap from 4.3.16 to 4.3.17 (#3157) 1 year ago
boa_engine Bump thiserror from 1.0.43 to 1.0.44 (#3163) 1 year ago
boa_examples Fix 1.71.0 lints (#3140) 1 year ago
boa_gc Copy `ABOUT.md` file to all published crates (#3074) 2 years ago
boa_icu_provider Copy `ABOUT.md` file to all published crates (#3074) 2 years ago
boa_interner Bump serde from 1.0.171 to 1.0.173 (#3156) 1 year ago
boa_macros Bump syn from 2.0.25 to 2.0.26 (#3153) 1 year ago
boa_macros_tests Bump trybuild from 1.0.81 to 1.0.82 (#3161) 1 year ago
boa_parser Format let-else expressions (#3102) 1 year ago
boa_profiler Copy `ABOUT.md` file to all published crates (#3074) 2 years ago
boa_runtime Bump indoc from 2.0.2 to 2.0.3 (#3142) 1 year ago
boa_tester Bump clap from 4.3.16 to 4.3.17 (#3157) 1 year ago
boa_wasm Removed time 0.1 dependency, updated dependencies (#3122) 1 year ago
docs Fix Grammar and Links in Docs (#2984) 2 years ago
fuzz Updated Fuzzer dependencies and added them to Dependabot (#3124) 1 year ago
test262@9d7eb8018e Bump test262 from `8ce9864` to `9d7eb80` (#3148) 1 year ago
.editorconfig New lexer (#559) 4 years ago
.gitattributes New lexer (#559) 4 years ago
.gitignore test: add wasm32 target e2e test (#2989) 2 years ago
.gitmodules Add ECMAScript test suite (test262) (#567) 4 years ago
.prettierignore create binaries for the releases (#3084) 1 year ago
ABOUT.md Added period to sentence (#2939) 2 years ago
CHANGELOG.md Changelog17 (#3101) 1 year ago
CODE_OF_CONDUCT.md Updated the Code of Conduct (#2365) 2 years ago
CONTRIBUTING.md Remove `boa_unicode` (#3070) 2 years ago
Cargo.lock Bump trybuild from 1.0.81 to 1.0.82 (#3161) 1 year ago
Cargo.toml Bump version to 0.17 (#3085) 2 years ago
LICENSE-MIT Added license files (#77) 6 years ago
LICENSE-UNLICENSE Added license files (#77) 6 years ago
README.md Add new CLI options to usage in README (#3123) 1 year ago
SECURITY.md Fix documentation links (#2741) 2 years ago
clippy.toml General code clean-up and new lint addition (#1809) 3 years ago
index.html Changelog17 (#3101) 1 year ago
index.js Changelog17 (#3101) 1 year ago
package-lock.json Bump webpack from 5.88.1 to 5.88.2 (#3150) 1 year ago
package.json Bump webpack from 5.88.1 to 5.88.2 (#3150) 1 year ago
test_ignore.toml Cleanup test262 features and bump submodule (#3051) 2 years ago
webpack.config.js test: add wasm32 target e2e test (#2989) 2 years ago

README.md

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 where test.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

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.