4 releases
0.6.3 | Jul 7, 2024 |
---|---|
0.6.2 | Jul 2, 2024 |
0.6.1 | Jun 30, 2024 |
0.6.0 | Jun 19, 2024 |
#1376 in Web programming
Used in 5 crates
(via hai_runtime)
3MB
90K
SLoC
QuickJS is a small and embeddable Javascript engine by Fabrice Bellard and Charlie Gordon. It supports the ES2023 specification including modules, asynchronous generators, proxies and BigInt.
Quickjs-NG is one of the most active forks of QuickJS, and it is maintained by the community focused on reigniting the project.
This crate allows you to easily access and use all the features of QuickJS from Rust. It also provides robust Rust-JS type conversion and interoperability capabilities.
Quickstart
[dependencies]
quickjs-rusty = "0.6.3"
use quickjs_rusty::{Context, JsValue};
let context = Context::new().unwrap();
// Eval.
let value = context.eval("1 + 2").unwrap();
assert_eq!(value, JsValue::Int(3));
let value = context.eval_as::<String>(" var x = 100 + 250; x.toString() ").unwrap();
assert_eq!(&value, "350");
// Callbacks.
context.add_callback("myCallback", |a: i32, b: i32| a + b).unwrap();
context.eval(r#"
// x will equal 30
var x = myCallback(10, 20);
"#).unwrap();
Note: This project is derived from quickjs-rs, but it has undergone significant restructuring. It features a completely different code structure and functional design compared to the original project.
Optional Features
The crate supports the following features:
serde
: (default enabled). enable serde methodfrom_js
andto_js
to transform between Rust types and js value in quickjs context. It should compatible withserde_json
but not tested yet. See more on the example.chrono
: (default enabled). chrono integration- adds a
JsValue::Date
variant that can be (de)serialized to/from a JSDate
- adds a
bigint
: (default enabled). arbitrary precision integer support via num-bigint
Installation
By default, quickjs is bundled with the libquickjs-sys
crate and
automatically compiled, assuming you have the appropriate dependencies.
Windows Support
quickjspp-rs can be used under target x86_64-pc-windows-msvc
,
System installation
To use the system installation, without the bundled feature, first install the required dependencies, and then compile and install quickjspp.
You then need to disable the bundled
feature in the libquickjs-sys
crate to
force using the system version.
Dependencies
~1.4–2.4MB
~44K SLoC