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] eed1134dc0 Bump serde_yaml from 0.9.16 to 0.9.17 (#2550) 2 years ago
.config Cleanup and speed-up CI (#2376) 2 years ago
.github Pass locale data provider by ref instead of boxing (#2508) 2 years ago
.vscode update tasks.json (#2313) 2 years ago
assets Added a logo to the project. (#277) 5 years ago
boa_ast Recognize Directive Prologues correctly (#2521) 2 years ago
boa_cli Implement host hooks and job queues APIs (#2529) 2 years ago
boa_engine Labelled ByteCompiler Fix (#2534) 2 years ago
boa_examples Redesign native functions and closures API (#2499) 2 years ago
boa_gc Redesign native functions and closures API (#2499) 2 years ago
boa_icu_provider Bump once_cell from 1.16.0 to 1.17.0 (#2510) 2 years ago
boa_interner Bump once_cell from 1.16.0 to 1.17.0 (#2510) 2 years ago
boa_macros Cleanup inline annotations (#2493) 2 years ago
boa_parser Correctly parse consecutive semicolons (#2533) 2 years ago
boa_profiler Bump once_cell from 1.16.0 to 1.17.0 (#2510) 2 years ago
boa_tester Bump serde_yaml from 0.9.16 to 0.9.17 (#2550) 2 years ago
boa_unicode Redesign Intl API and implement some services (#2478) 2 years ago
boa_wasm Restructure lints in multiple crates (#2447) 2 years ago
docs Implement instruction flowgraph generator (#2422) 2 years ago
fuzz VM Fuzzer (#2401) 2 years ago
test262@2ac0d3c47b Bump test262 from `e1048d0` to `2ac0d3c` (#2538) 2 years ago
.editorconfig New lexer (#559) 4 years ago
.gitattributes New lexer (#559) 4 years ago
.gitignore Update `yarn.lock` and add `build:prod` command (#1910) 3 years ago
.gitmodules Add ECMAScript test suite (test262) (#567) 4 years ago
.prettierignore Rename "Boa" to boa_engine, moved GC and profiler to their crates (#1844) 3 years ago
CHANGELOG.md Added the changelog for 0.16 (#2303) 2 years ago
CODE_OF_CONDUCT.md Updated the Code of Conduct (#2365) 2 years ago
CONTRIBUTING.md Migrate to NPM and cleanup Playground (#1951) 3 years ago
Cargo.lock Bump serde_yaml from 0.9.16 to 0.9.17 (#2550) 2 years ago
Cargo.toml Redesign Intl API and implement some services (#2478) 2 years ago
LICENSE-MIT Added license files (#77) 6 years ago
LICENSE-UNLICENSE Added license files (#77) 6 years ago
README.md Fix links in readme (#2304) 2 years ago
bors.toml Cleanup and speed-up CI (#2376) 2 years ago
clippy.toml General code clean-up and new lint addition (#1809) 3 years ago
index.html Migrate to NPM and cleanup Playground (#1951) 3 years ago
index.js Migrate to NPM and cleanup Playground (#1951) 3 years ago
package-lock.json Bump prettier from 2.8.2 to 2.8.3 (#2535) 2 years ago
package.json Bump prettier from 2.8.2 to 2.8.3 (#2535) 2 years ago
test_ignore.toml Redesign Intl API and implement some services (#2478) 2 years ago
webpack.config.js Migrate to NPM and cleanup Playground (#1951) 3 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://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 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]...

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.