github
/
boa
mirror of https://github.com/boa-dev/boa.git
1
0
Fork 0
Code Issues Releases Wiki Activity
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.
319 Commits
22 Branches
25 Tags
689 MiB
 
 
Tree: 495f0a4868
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '495f0a4868'
${ noResults }
Jason Williams 495f0a4868
String.prototype.replace() (#217) 		5 years ago
.devcontainer debugging in dev container can now step into Rust Std code (#219) 5 years ago
.github/workflows change title 5 years ago
.vscode fix git checkout (benchmark action), try v2 5 years ago
assets web assembly demo updates 6 years ago
benches add parser benchmark for expressions (#226) 5 years ago
docs adding debugging section to docs 5 years ago
src String.prototype.replace() (#217) 5 years ago
.editorConfig adding Dockerfile for rust 6 years ago
.gitignore Feature/number object (#182) 5 years ago
CHANGELOG.md Update CHANGELOG.md 5 years ago
CONTRIBUTING.md Update CONTRIBUTING.md 5 years ago
Cargo.lock Updates and removing console logs 5 years ago
Cargo.toml add parser benchmark for expressions (#226) 5 years ago
Dockerfile Set proper base for boashell (#107) 5 years ago
LICENSE-MIT Added license files (#77) 5 years ago
LICENSE-UNLICENSE Added license files (#77) 5 years ago
Makefile adding Dockerfile for rust 6 years ago
README.md String.prototype.replace() (#217) 5 years ago
index.html Updates and removing console logs 5 years ago
index.js Updates and removing console logs 5 years ago
package.json Updates and removing console logs 5 years ago
webpack.config.js Updates and removing console logs 5 years ago
yarn.lock Updates and removing console logs 5 years ago

README.md

Boa

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

Live Demo (WASM)

https://jasonwilliams.github.io/boa/

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

Benchmarks

https://jasonwilliams.github.io/boa/dev/bench/

Contributing

If you don't already have Rust installed rustup is the recommended tool to use. It will install Rust and allow you to switch between nightly, stable and beta. You can also install additional components.

curl https://sh.rustup.rs -sSf | sh

Then simply clone this project and cargo build inside the directory.

VSCode

Plugins

Either the Rust (RLS) or the Rust Analyzer extension is preferred. RLS is easier to set up but most of the development is moving towards Rust Analyzer.
Both of these plugins will help you with your Rust Development

Tasks

There are some pre-defined tasks in tasks.json

  • Build - shift+cmd/ctrl+b should build and run cargo. You should be able to make changes and run this task.
  • Test - (there is no shortcut, you'll need to make one) - Runs Cargo Test.
    I personally set a shortcut of shift+cmd+option+T (or shift+ctrl+alt+T)

If you don't want to install everything on your machine, you can use the Dockerfile. Start VSCode in container mode (you may need the docker container plugin) and use the Dockerfile.

Debugging

See Debugging

Web Assembly

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

$ yarn install
$ yarn serve

In the console you can use window.evaluate to pass JavaScript in To develop on the web assembly side you can run yarn serve then go to http://localhost:8080

Roadmap

See Milestones

Changelog

see CHANGELOG

Usage

  • Clone this repo
  • Run with cargo run -- test.js where test.js is an existing JS file
  • If any JS doesn't work then it's a bug. Please raise an issue!

Communication

Feel free to contact us on Discord https://discord.gg/tUFFk9Y

Example

Example

License

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