stencil-hq/dquickts

选用指南

AI 根据 README 整理 · 2026/10/24 04:26:43

使用方式

通过命令行使用，支持直接运行TypeScript文件，也提供REPL模式。

查看 README 依据

git clone https://github.com/stencil-hq/dquickts cd dquickts make # builds qjs, qjsc and libquickjs.a ./qjs hello.ts ./qjs --drepl session.snap # a REPL whose state survives restarts make test-snapshot # builds and runs the suspension and snapshot test hosts ``` ## Contents - [What this fork adds](#what-this-fork-adds) - [Durable REPL](#durable-repl) - [Snapshots](#snapshots) - [What a snapshot is](#what-a-snapshot-is) - [When you can take one](#when-you-can-take-one) - [Example: hibernating in the middle of a loop](#example-hibernating-in-the-middle-of-a-loop)

部署要求

需要从源码编译，依赖C编译器和make工具。

查看 README 依据

git clone https://github.com/stencil-hq/dquickts cd dquickts make # builds qjs, qjsc and libquickjs.a ./qjs hello.ts ./qjs --drepl session.snap # a REPL whose state survives restarts make test-snapshot # builds and runs the suspension and snapshot test hosts ``` ## Contents - [What this fork adds](#what-this-fork-adds) - [Durable REPL](#durable-repl) - [Snapshots](#snapshots) - [What a snapshot is](#what-a-snapshot-is) - [When you can take one](#when-you-can-take-one) - [Example: hibernating in the middle of a loop](#example-hibernating-in-the-middle-of-a-loop)

已知限制

快照只能加载到写入它的同一构建版本中；不支持包含Intl或Temporal上下文的快照；同一时间只能有一个挂起的执行。

查看 README 依据

- The `std` and `os` modules are not available. Their files, timers and handlers are host state that a snapshot cannot save. - `\load file` evaluates a file inside the session. - Ctrl-C interrupts a running command. The session is not affected. - A session file only loads into the `qjs` build that wrote it. - Tab completion lists properties of the global object. Like the regular REPL, it does not list top-level `let`, `const` and `class` names, but it does complete their members (`c.in` → `c.inc()`). ## Snapshots ### What a snapshot is

a restore: the interrupt handler, module loader, memory and stack limits, promise rejection tracker, context opaque pointers, and locale callbacks. Modules imported after the restore go through the new runtime's loader. - **Buffers.** `ArrayBuffer` data is always restored into memory the engine owns. Host buffers are copied, and their free functions are not kept. ### Limitations - `JS_WriteSnapshot()` throws a `TypeError` for: - contexts with the Intl or Temporal intrinsics, - `SharedArrayBuffer`s whose memory may be shared with another thread,

- host-class objects with opaque data when there is no `save_opaque()` hook, - C closures (`JS_NewCClosure()`), whose opaque pointer is host state, - any call made while JS code is running on the C stack. - A runtime can have only one suspended execution at a time. - If a suspended frame cannot be resumed (stack overflow, or the interrupt handler interrupts it), it and its callees are terminated without running `catch`/`finally` blocks or `using` disposals. The error is thrown at the frame's call site.