JavaScriptCore API for Rust
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
jscto avoid the dependency to GTK.
Getting Started
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.
#[callback]
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!
}
FAQ
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.
0 Jul 23, 2022
5 Nov 17, 2022
6 Dec 27, 2022
3 Jan 7, 2023
13 Mar 21, 2023
97 Apr 14, 2023
4 Oct 17, 2023
6 Dec 22, 2023
4 Feb 26, 2024
885 Jan 9, 2023
3 Jan 9, 2023
6 Jan 14, 2023
11 Feb 28, 2023
655 Jul 13, 2023
4 Sep 19, 2023
4 Sep 26, 2023
4 Nov 7, 2023
5 Nov 13, 2023
364 Dec 28, 2022