3 unstable releases

0.1.0 Apr 28, 2023
0.0.3 Sep 24, 2022
0.0.2 Sep 2, 2022

#1324 in Procedural macros

Download history 592/week @ 2023-06-08 931/week @ 2023-06-15 969/week @ 2023-06-22 463/week @ 2023-06-29 779/week @ 2023-07-06 354/week @ 2023-07-13 622/week @ 2023-07-20 290/week @ 2023-07-27 513/week @ 2023-08-03 278/week @ 2023-08-10 751/week @ 2023-08-17 542/week @ 2023-08-24 717/week @ 2023-08-31 428/week @ 2023-09-07 435/week @ 2023-09-14 282/week @ 2023-09-21

1,977 downloads per month
Used in 4 crates (via rusty_jsc)

MIT license

76 lines

JavaScriptCore API for Rust

crates docs

This library provides a Rust API for the JavaScriptCore engine with the following goals:

  • High-level API like the JavaScriptCore API for Swift
  • Wrap the low-level C++ API instead of jsc to avoid the dependency to GTK.

Getting Started

Implementing a JavaScript runtime

Please check out PunJS for an example of how to implement a JavaScript runtime with rusty_jsc.

Evaluating a JavaScript script

use rusty_jsc::JSContext;

let mut context = JSContext::default();
let value = context.evaluate_script("'hello, world'", 1);
if let Some(value) = value {
    println!("{}", value.to_string(&context));
    // Prints:
    // hello, world

Callbacks from JavaScript to Rust

use rusty_jsc::{JSContext, JSValue};
use rusty_jsc_macros::callback;

// The JavaScript code calls this Rust function.
fn foo(_context: JSContext) {
    println!("hello from Rust land!");

fn main() {
    let mut context = JSContext::default();
    let callback = JSValue::callback(&context, Some(foo));
    let mut global = context.get_global_object();
    global.set_property(&context, "foo".to_string(), callback);
    context.evaluate_script("foo()", 1);
    // Prints:
    // hello from Rust land!


What about the other JavaScriptCore bindings for Rust?

The wrappers in rusty_jsc are built against <JavaScriptCore/JavaScript.h> header rather than the jsc variant that requires GTK.

Why JavaScriptCore when there's already rusty_v8?

Bun has shown that JavaScriptCore is a worthy contender to V8 on the server-side, so let's bring it over to the Rust ecosystem as well.

How were the C++ low-level bindings generated?

I first used bindgen to do the rough conversion of JavaScript/JavaScript.h header and then cleaned it up by hand. The plan is to maintain the low-level bindings by hand.


~30K SLoC