JavaScriptCore API for Rust

该库提供了对 JavaScriptCore 引擎的 Rust API，具有以下目标

• 类似于 JavaScriptCore API 的 Swift 高级 API
• 封装低级 C++ API 而不是 jsc 以避免对 GTK 的依赖。

入门指南

实现 JavaScript 运行时

请查看 PunJS 以了解如何使用 rusty_jsc 实现JavaScript运行时的示例。

评估 JavaScript 脚本

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
}

从 JavaScript 到 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!
}

常见问题解答

关于其他 Rust 的 JavaScriptCore 绑定怎么办？

rusty_jsc 中的包装器是针对 <JavaScriptCore/JavaScript.h> 头文件构建的，而不是需要 GTK 的 jsc 变体。

为什么选择 JavaScriptCore，而不是已经存在的 rusty_v8？

Bun 已经表明 JavaScriptCore 是服务器端 V8 的有力竞争者，所以让我们也将其带到 Rust 生态系统。

C++ 低级绑定是如何生成的？

我首先使用 bindgen 对 JavaScript/JavaScript.h 头文件进行初步转换，然后手动清理。计划手动维护低级绑定。