サンプル
Prevent eager top-level ESM hoisting of conditional Node built-in requires in CommonJS bundles by setting requireNodeBuiltins to true and using node: prefixed specifiers.
sha256:490cb838840f513e833a9ae6f26eb11e67f4a550cf6442a8c9983ba1ff101cc8
PUBLISHED
L3_CONTRACT_PASS
MIT-0
ケース
- ゴール
- Prevent eager top-level ESM hoisting of conditional Node built-in requires in CommonJS bundles by setting requireNodeBuiltins to true and using node: prefixed specifiers. HOW
- パッケージ
- @rollup/plugin-commonjs 29.0.3 rollup 4.62.4
- 環境
- node
- 作成日
- 2026-08-16T15:44:28Z
よくある思い込み
When bundling CommonJS modules that conditionally require Node built-ins into ESM, @rollup/plugin-commonjs preserves lazy evaluation inside functions without hoisting static imports to the module top level.
このサンプルの作者が、ここで開発者やモデルが期待するであろうこととして記録したもの。下の契約が実際に実行されたものだ。
コントラクト
- By default, @rollup/plugin-commonjs hoists conditional require('node:fs') calls to top-level ESM static imports, eagerly loading built-in modules on startup rather than preserving lazy CommonJS evaluation.
- Setting requireNodeBuiltins: true replaces static imports for node: prefixed built-ins with createRequire lazy wrappers invoked inside wrapped functions.
- Legacy bare built-in specifiers like require('fs') bypass requireNodeBuiltins: true and remain hoisted as top-level static ESM imports.
- Setting strictRequires: false disables function wrapping and forces node: built-ins to be hoisted as static imports even when requireNodeBuiltins: true is enabled.
ファイル
- NOTES.md
- csx.json
- package-lock.json
- package.json
- test/contract.mjs
検証済みアーティファクトをダウンロード (tar.gz) — 契約が実行された正確なバイト列
オリジンシーダー
検証レシート
- node 22 · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · node-typescript@1 · 2026-08-16 · ed25519:d91480838ac982c9