mirror of
https://github.com/vercel-labs/scriptc.git
synced 2026-11-03 07:54:40 +08:00
Chris Tate
055c9ffa25
Preflight admits a createRequire loader's require.resolve call with a
computed request inside a try block, but lowering refused the call, so
in JavaScript source the whole statement became a runtime fence. The
fence threw before the request expression ran, and before anything else
in the statement: `try { where = load.resolve(candidate(name)); }`
skipped candidate()'s side effects, so the catch clause saw a different
state than in Node.
Such calls (a computed request, another argument shape, or
runtime-computed options, on require.resolve and require.resolve.paths)
now evaluate their arguments in order and then throw the fence, as a
computed require call does. The addon-probe fixture checks that a
computed candidate path runs before each failed lookup.
14 lines
1.1 KiB
Plaintext
14 lines
1.1 KiB
Plaintext
Node-API (N-API) and V8 `.node` addons depend on Node.js itself, so compiled programs can't load them.
|
|
Direct `createRequire` calls to local addons are rejected at compile time.
|
|
A package that requires an addon needs a JavaScript implementation that compiles, or a replacement through native FFI.
|
|
|
|
A package that looks for an optional addon at run time compiles with `--npm-static` when the lookup is inside a `try` block.
|
|
There, a `createRequire` require call with a computed specifier, and a `require.resolve` or `require.resolve.paths` call with a computed request, evaluate their arguments and then throw an error.
|
|
Its `require.resolve` read as a value is a function that throws when called.
|
|
Coverage lists these as deferred to runtime.
|
|
The package's `catch` clause then runs as it does in Node.js when the addon is missing.
|
|
Outside a `try` block, the same uses keep the package refused.
|
|
|
|
Use [Native FFI](/docs/ffi#replacing-a-node-api-addon) to call a plain C ABI function linked from an object or static archive.
|
|
The guide includes a replacement for a small Node-API helper.
|