Rust编写的JavaScript引擎,该项目是一个试验性质的项目。
Nevar pievienot vairāk kā 25 tēmas Tēmai ir jāsākas ar burtu vai ciparu, tā var saturēt domu zīmes ('-') un var būt līdz 35 simboliem gara.
 
 
Haled Odat 2873a3b414 Implement Ascii JsString pirms 2 nedēļām
.config Cleanup and speed-up CI (#2376) pirms 1 gada
.github Add a catch all for other categories not labelled (#3703) pirms 4 nedēļām
.vscode Reestructure repo and CI improvements (#3505) pirms 4 mēnešiem
assets Using different logos depending on theme (#3720) pirms 3 nedēļām
cli Implement Ascii JsString pirms 2 nedēļām
core Implement Ascii JsString pirms 2 nedēļām
docs Implement Ascii JsString pirms 2 nedēļām
examples Implement Ascii JsString pirms 2 nedēļām
ffi/wasm Split ICU4X data generation from `boa_icu_provider` (#3682) pirms 4 nedēļām
tests Implement Ascii JsString pirms 2 nedēļām
tools Split ICU4X data generation from `boa_icu_provider` (#3682) pirms 4 nedēļām
.editorconfig New lexer (#559) pirms 4 gadiem
.gitattributes New lexer (#559) pirms 4 gadiem
.gitignore Ignore `Cargo.lock` in fuzzer (#3636) pirms 2 mēnešiem
.prettierignore Reestructure repo and CI improvements (#3505) pirms 4 mēnešiem
ABOUT.md Clippy updates: add panics and etc. (#3235) pirms 7 mēnešiem
CHANGELOG.md initial changelog for v0.18 (#3691) pirms 3 nedēļām
CODE_OF_CONDUCT.md Updated the Code of Conduct (#2365) pirms 1 gada
CONTRIBUTING.md Prevent `test262` repository update if not needed (#3386) pirms 5 mēnešiem
Cargo.lock Implement Ascii JsString pirms 2 nedēļām
Cargo.toml Add release binary striping (#3727) pirms 3 nedēļām
LICENSE-MIT Added license files (#77) pirms 5 gadiem
LICENSE-UNLICENSE Added license files (#77) pirms 5 gadiem
README.md Using different logos depending on theme (#3720) pirms 3 nedēļām
SECURITY.md Fix documentation links (#2741) pirms 1 gada
clippy.toml General code clean-up and new lint addition (#1809) pirms 2 gadiem
index.html Changelog17 (#3101) pirms 9 mēnešiem
index.js Reestructure repo and CI improvements (#3505) pirms 4 mēnešiem
package-lock.json Bump @playwright/test from 1.42.0 to 1.42.1 (#3714) pirms 3 nedēļām
package.json Bump @playwright/test from 1.42.0 to 1.42.1 (#3714) pirms 3 nedēļām
test262_config.toml Implement RegExp `v` flag (#3695) pirms 4 nedēļām
webpack.config.js Reestructure repo and CI improvements (#3505) pirms 4 mēnešiem

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)

Try out the engine now at the live WASM playground here!

Prefer a CLI? Feel free to try out boa_cli!

Boa Crates

Boa currently publishes and actively maintains the following crates:

  • boa_ast - Boa's ECMAScript Abstract Syntax Tree
  • boa_cli - Boa's CLI && REPL implementation
  • boa_engine - Boa's implementation of ECMAScript builtin objects and execution
  • boa_gc - Boa's garbage collector
  • boa_interner - Boa's string interner
  • boa_parser - Boa's lexer and parser
  • boa_profiler - Boa's code profiler
  • boa_icu_provider - Boa's ICU4X data provider
  • boa_runtime - Boa's WebAPI features

Please note: the Boa and boa_unicode crate are deprecated.

Boa Engine Example

To use Boa simply follow the below.

Add the below dependency to your Cargo.toml:

[dependencies]
boa_engine = "0.17.3"

Then in main.rs, copy the below:

use boa_engine::{Context, Source, JsResult};

fn main() -> JsResult<()> {
  let js_code = r#"
      let two = 1 + 1;
      let definitely_not_four = two + "2";

      definitely_not_four
  "#;

  // Instantiate the execution context
  let mut context = Context::default();

  // Parse the source code
  let result = context.eval(Source::from_bytes(js_code))?;

  println!("{}", result.display());

  Ok(())
}

Now, all that's left to do is cargo run.

Congrats! You've executed your first JavaScript using Boa!

Documentation

For more information on Boa's API. Feel free to check out our documentation.

Release Documentation

Dev main Documentation

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.