earendil-works/djs

选用指南

AI 根据 README 整理 · 2026/11/6 09:16:41

使用方式

可通过命令行运行脚本，也可作为 JavaScript 包导入使用 Sandbox API。

查看 README 依据

Requirements: stable Rust (edition 2024) with the `wasm32-unknown-unknown` target and the `rust-src` component (the wasm module builds core and alloc from source), node 22.6 or newer for the JS host package (it runs TypeScript directly), and, for the oracle-based tests, dquickts' `qjs` at `~/Development/dquickts/qjs` (or `$DJS_QJS`). ```sh cargo build # the workspace cargo run -p djs-cli -- run file.js # run a Script (prints console output) cargo run -p djs-cli -- run --body file.js # run a codemode async function body

@earendil-works/djs`; js/README.md, docs/host.md): ```ts import { Sandbox } from "@earendil-works/djs"; import { loadModule as loadDumpModule } from "@earendil-works/djs/dump"; const sb = await Sandbox.create({ asyncFunctions: { search: (q) => mySearch(q as string) }, memoryLimit: 64 << 20, frozenBuiltins: true, // dumps need them (D2836) dumpModule: await loadDumpModule(), // only to persist runs }); const result = await sb.runAsync("const hits = await search(q); return hits.length;", { q: "djs" });

部署要求

需要 stable Rust (edition 2024) 和 wasm32-unknown-unknown 目标，以及 node 22.6 或更高版本。

查看 README 依据

Requirements: stable Rust (edition 2024) with the `wasm32-unknown-unknown` target and the `rust-src` component (the wasm module builds core and alloc from source), node 22.6 or newer for the JS host package (it runs TypeScript directly), and, for the oracle-based tests, dquickts' `qjs` at `~/Development/dquickts/qjs` (or `$DJS_QJS`). ```sh cargo build # the workspace cargo run -p djs-cli -- run file.js # run a Script (prints console output) cargo run -p djs-cli -- run --body file.js # run a codemode async function body

已知限制

设计上跳过 Intl、Temporal、SharedArrayBuffer/Atomics、Annex B、sloppy mode、direct eval 和 modules。

查看 README 依据

- pi's codemode test suite on djs: 221 of 226 tests pass in the default mode, in the next mode and with a dump at every idle point (measured at 7167411f0f, 2026-11-05). <!-- /gen --> Skipped by design: Intl, Temporal, SharedArrayBuffer/Atomics, Annex B, sloppy mode, direct eval, modules. Most known failures follow from djs being always strict (TESTING.md "Known differences"); pi's failures from that, or from tests that expect the quickjs-wasi fingerprint. **Speed in wasm** (node, V8's wasm tier). djs-wasm vs quickjs-wasi (pi's engine), from `scripts/perf/wmeasure.py`: