trueharuu / dash

Experimental JavaScript implementation in Rust

dash

ECMA-262 implementation in pure Rust.

⚠️ WIP

This is a WIP and not yet production ready. It is actively being worked on and the API is constantly changing.

Current status: Not recommended for use in real projects. Feel free to experiment. The majority of language constructs are implemented and "work fine". It currently passes around 16% of test262.

Usage

Using the CLI

import * as http from '@std/http';

// We already implement Optional Typing, so you can directly annotate parameters and variables with types
// without having to use a third tool such as tsc
function* counter(start: number) {
    let num = start;
    while (true) yield num++;
}

const numbers = counter(0);
const port = 3030;

http.listen(port, (ctx) => {
    const next = numbers.next();
    ctx.respond('Request count: ' + next.value);
});

console.log('Listening on port: ' + port);

# Install Rust
$ curl -sSf https://sh.rustup.rs | sh
# Clone repo
$ git clone https://github.com/y21/dash
# Build cli
$ cd dash/cli && cargo install --path .
# Optional: rename binary to `dashjs`
$ mv ~/.cargo/bin/dash-cli ~/.cargo/bin/dashjs
# Run the program (run with --help for help)
$ dashjs run example.js

Now open up your browser, navigate to http://localhost:3030, refresh a bunch of times and see the numbers go up.

JIT

This engine has basic support for JIT compilation. It uses LLVM for optimizations and codegen, based on specialized type information and branches tracked by tracing iterations of hot loops.

You can enable it by passing the jit feature flag to the dash_vm crate. Beware that it's a very early WIP, expect bugs and crashes!

Embedding into a Rust application

Note that the API is not stable. Things are constantly changing, so your code may break at any time when bumping the version, which is why it is highly recommended to lock in to a specific revision for now.

• Cargo.toml

[dependencies]
dash_vm = { git = "https://github.com/y21/dash", features = ["eval"] }

The eval feature exposes a convenience eval() method on the Vm struct that lets you specify a JavaScript source string directly.

• main.rs

use dash_vm::Vm;

fn main() {
    let source = "const x = 42; x * x";

    let mut vm = Vm::new(Default::default());
    let result = vm.eval(source, Default::default()).expect("JS Exception");

    println!("Result: {}", match result {
        Value::Number(n) => n,
        _ => unreachable!()
    });
}

_{See dash-cli/ for a more detailed example}