Files
d8c489383a Update QuickJS-NG to v0.12.1 via amalgamation (#244)
* Add vendor script for quickjs-ng and update to v0.12.1 amalgam

- Add scripts/vendor-quickjs-ng.sh to download release amalgam zip
- Update vendor/quickjs-ng to v0.12.1 amalgamated build
- Update Variant.mk to use quickjs-amalgam.o for quickjs-ng variants
- Fix c/interface.c compatibility with quickjs-ng:
  - Remove cutils.h include (not in amalgam)
  - Add BOOL compatibility define (quickjs-ng uses C99 bool)
  - Add QTS_JS_IsBigInt macro (different signatures)

Note: Some quickjs-ng tests are failing due to API differences in
promise handling. This needs further investigation.

* Fix quickjs-ng build and test failures

- Add forward declaration for js_std_dump_error (needed for debug builds)
- Add -DQJS_BUILD_LIBC to enable libc functions in quickjs-ng amalgam
- Disable JS_DetectModule for quickjs-ng: it parses code as a module and
  returns true if parsing succeeds, but any valid JS expression is valid
  module syntax, so it incorrectly detects non-modules as modules
- Regenerate variant Makefiles with the updated template

All tests pass.

* rebuild

* Update vendor-quickjs-ng.sh to auto-fetch latest release

When no version argument is provided, the script now queries the GitHub
API to get the latest release tag and uses that version.

* Simplify vendor:ng:pull to use vendor-quickjs-ng.sh

Remove vendor:ng:subtree and vendor:ng:add scripts since we now vendor
quickjs-ng from release amalgam instead of git subtree.

* Link quickjs-ng docs to release tag instead of commit SHA

Add CLibraryUsesTagVersion to indicate which libraries should link to
their VERSION file as a release tag instead of using git subtree SHA.

quickjs-ng now links to releases/tag/v0.12.1 instead of commit/SHA.

* fix variant links for quickjs-ng

---------

Co-authored-by: Hanzo Dev <[email protected]>
2026-02-15 08:16:29 +00:00

3.6 KiB

@jitl/quickjs-ng-wasmfile-debug-asyncify

Variant with separate .WASM file. Supports browser ESM, NodeJS ESM, and NodeJS CommonJS.

This generated package is part of quickjs-emscripten. It contains a variant of the quickjs WASM library, and can be used with quickjs-emscripten-core.

import variant from "@jitl/quickjs-ng-wasmfile-debug-asyncify"
import { newQuickJSAsyncWASMModuleFromVariant } from "quickjs-emscripten-core"
const QuickJS = await newQuickJSAsyncWASMModuleFromVariant(variant)

This variant was built with the following settings:

Library: quickjs-ng

quickjs-ng is a fork of quickjs that tends to add features more quickly.

Version v0.12.1 vendored to quickjs-emscripten.

Release mode: debug

Enables assertions and memory sanitizers. Try to run your tests against debug variants, in addition to your preferred production variant, to catch more bugs.

Exports: require import browser workerd

Exports the following in package.json for the package entrypoint:

  • Exports a NodeJS-compatible CommonJS module, which is faster to load and run compared to an ESModule.
  • Exports a NodeJS-compatible ESModule. Cannot be imported synchronously from a NodeJS CommonJS module.
  • Exports a browser-compatible ESModule, designed to work in browsers and browser-like environments.
  • Targets Cloudflare Workers.

Extra async magic? Yes

Build run through the ASYNCIFY WebAssembly transform. This imposes substantial size (2x the size of sync) and speed penalties (40% the speed of sync). In return, allows synchronous calls from the QuickJS WASM runtime to async functions on the host. The extra magic makes this variant slower than sync variants. Note that both variants support regular async functions. Only adopt ASYNCIFY if you need to! The QuickJSAsyncRuntime and QuickJSAsyncContext classes expose the ASYNCIFY-specific APIs.

Single-file, or separate .wasm file? wasm

Has a separate .wasm file. May offer better caching in your browser, and reduces the size of your JS bundle. If you have issues, try a 'singlefile' variant.

More details

Full variant JSON description:

{
  "library": "quickjs-ng",
  "releaseMode": "debug",
  "syncMode": "asyncify",
  "description": "Variant with separate .WASM file. Supports browser ESM, NodeJS ESM, and NodeJS CommonJS.",
  "emscriptenInclusion": "wasm",
  "exports": {
    "require": {
      "emscriptenEnvironment": ["node"]
    },
    "import": {
      "emscriptenEnvironment": ["node"]
    },
    "browser": {
      "emscriptenEnvironment": ["web", "worker"]
    },
    "workerd": {
      "emscriptenEnvironment": ["web"]
    }
  }
}

Variant-specific Emscripten build flags:

[
  "-s ASYNCIFY=1",
  "-DQTS_ASYNCIFY=1",
  "-DQTS_ASYNCIFY_DEFAULT_STACK_SIZE=81920",
  "-s ASYNCIFY_STACK_SIZE=81920",
  "-s ASYNCIFY_REMOVE=@$(BUILD_WRAPPER)/asyncify-remove.json",
  "-s ASYNCIFY_IMPORTS=@$(BUILD_WRAPPER)/asyncify-imports.json",
  "-lasync.js",
  "-O0",
  "-DQTS_DEBUG_MODE",
  "-DDUMP_LEAKS=1",
  "-gsource-map",
  "-s ASSERTIONS=1",
  "--pre-js $(TEMPLATES)/pre-extension.js",
  "--pre-js $(TEMPLATES)/pre-sourceMapJson.js",
  "--pre-js $(TEMPLATES)/pre-wasmOffsetConverter.js",
  "--pre-js $(TEMPLATES)/pre-wasmMemory.js",
  "-O3"
]