pnpm を 10 から 11 に上げると動かなくなること
pnpm を 10 から 11 に上げると、Node.js 20 では起動しなくなり、.npmrc と package.json の pnpm フィールドに書いた設定が読まれなくなる。
許可していないビルドスクリプトでは install が失敗する。
10.34 と 11.28 で打ち比べた 9 つの変更点と直し方をまとめる。
公開: 更新:
npm で pnpm@10 と pnpm@11 を別の場所に入れ、同じファイルを置いたプロジェクトで同じコマンドを打ち比べた。
各節の出力は「v10 では」「v11 に上げると」「v11 で直すと」の 3 段で並ぶ。
Node.js は 24.22.2 を使い、最初の節だけ Node.js 20.20.2 に替えている。package.json は手で書いた。packageManager を書いていないので、どちらの pnpm も別の版に切り替わらずにそのまま動いている。
packageManager や devEngines.packageManager で pnpm の版を固定しているプロジェクトでは、11 を入れても固定した版に切り替わって動く。
リリースノートによると、この切り替えを決める pmOnFail の既定は download である。
このページの最後の節では、11 が固定された 12 に切り替わっている。
上げるときは、固定した版も 11 に書き換える。
公式の移行ガイドには codemod(pnpx codemod run pnpm-v10-to-v11)があり、.npmrc と package.json の pnpm フィールドに書いた設定を pnpm-workspace.yaml へ移す。
ビルドスクリプトの設定の allowBuilds への書き換えと、packageManager の版の書き換えもこれに含まれる。
このページでは codemod を打たず、直し方は手で書いた。
動かなくなる原因は 4 つに分かれる。
1 つ目は、Node.js 22 より前で動かなくなったことである。
2 つ目は設定の置き場で、認証・レジストリ・ネットワーク以外の設定は pnpm-workspace.yaml かグローバルの config.yaml に書くものになった。.npmrc・package.json・npm_config_* の環境変数に書いた設定は読まれない。
3 つ目は安全側に倒した既定で、許可していないビルドスクリプトは install を失敗させ、公開から 1 日たっていない版は選ばれない。
4 つ目は出力と雛形の変化で、peer 依存の一覧が install から消え、pnpm init が "type": "module" を書く。
次の変更は、このページでは打っていない。
pnpm add -gで入れるパッケージは 1 つずつ別のディレクトリに入り、グローバルのコマンドはPNPM_HOMEの下のbinに置かれるようになった。
上げたあとにpnpm setupを打ち直す。pnpm linkは名前を受け付けなくなり、./fooのようなパスだけを取る。pnpm link --globalと引数なしのpnpm linkも無くなった。pnpm auditの無視する脆弱性の指定は、auditConfig.ignoreCvesから GHSA の ID を書くauditConfig.ignoreGhsasに変わった。blockExoticSubdepsが既定で有効になり、間接的な依存は Git や tarball の URL から入れられなくなった。managePackageManagerVersionsなどの 3 つの設定はpmOnFailにまとまり、useNodeVersionとignorePatchFailuresは無くなった。clean・setup・deploy・rebuildという名前のスクリプトは、同じ名前の組み込みのコマンドより先に走る。pnpm publishは npm を呼ばなくなり、ワンタイムパスワードの環境変数はPNPM_CONFIG_OTPになった。
ストアは v11 になり、索引が SQLite に移った。verifyDepsBeforeRunの既定がinstallになり、pnpm runの前に依存が古ければ install が走る。
スクリプトを走らせたときに出る行も、> pkg@version stage pathから$ commandに変わり、標準エラーに出るようになった。
ほかの変更も含めた一覧は 11.0.0 のリリースノート(新しいタブで開く) にある。
11.0.0 のリリースノートは、npm に処理を渡していた pnpm pkg などのコマンドが「not implemented」のエラーになると書いている。
その後、11.3.0 で pkg が pnpm 自身の実装に戻り、bugs・owner・access なども 11 系のうちに戻った。
リポジトリの .npmrc に書いた ${NPM_TOKEN} を展開しなくなった変更は、公式のブログによると 10.34.2 と 11.5.3 の両方に入っている。
10 の最新から上げるなら、この 2 つは 10 と 11 の差にならない。
Node.js 20 では pnpm 11 が起動しない
11.0.0 のリリースノートは、Node.js 18・19・20・21 を対象から外したと書いている。
pnpm 自身も ES モジュールだけで配られるようになった。
Node.js 20 のまま pnpm だけを 11 に上げると、pnpm install は起動の段階で落ちる。
v10 では
$ node --version
v20.20.2$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Progress: resolved 2, reused 0, downloaded 2, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 513ms using pnpm v10.34.9
$ echo $?
0v11 に上げると
$ node --version
v20.20.2$ pnpm install
warn: This version of pnpm requires at least Node.js v22.13
warn: The current version of Node.js is v20.20.2
warn: Visit https://r.pnpm.io/comp to see the list of past pnpm versions with respective Node.js version support.
node:internal/modules/cjs/loader:1031
throw new ERR_UNKNOWN_BUILTIN_MODULE(request);
^
Error [ERR_UNKNOWN_BUILTIN_MODULE]: No such built-in module: node:sqlite
at Module._load (node:internal/modules/cjs/loader:1031:13)
at Module.require (node:internal/modules/cjs/loader:1289:19)
at require (node:internal/modules/helpers:182:18)
at ../store/index/lib/index.js (file:///opt/pnpm11/lib/node_modules/pnpm/dist/pnpm.mjs:146954:25)
at __init (file:///opt/pnpm11/lib/node_modules/pnpm/dist/pnpm.mjs:17:58)
at ../fetching/git-fetcher/lib/index.js (file:///opt/pnpm11/lib/node_modules/pnpm/dist/pnpm.mjs:147489:5)
at __init (file:///opt/pnpm11/lib/node_modules/pnpm/dist/pnpm.mjs:17:58)
at ../installing/client/lib/index.js (file:///opt/pnpm11/lib/node_modules/pnpm/dist/pnpm.mjs:154979:5)
at __init (file:///opt/pnpm11/lib/node_modules/pnpm/dist/pnpm.mjs:17:58)
at lib/checkForUpdates.js (file:///opt/pnpm11/lib/node_modules/pnpm/dist/pnpm.mjs:155539:5) {
code: 'ERR_UNKNOWN_BUILTIN_MODULE'
}
Node.js v20.20.2
$ echo $?
1v11 で直すと
$ node --version
v24.22.2$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 2, reused 0, downloaded 2, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 732ms using pnpm v11.28.11
$ echo $?
011 は最初に Node.js v22.13 以上が要ると警告し、続けて node:sqlite という組み込みのモジュールが無いというエラーで落ちた。
スタックトレースのとおり、11 のストアの索引(store/index)がこのモジュールを読み込む。
11.0.0 のリリースノートによると、索引は 11 で 1 つの SQLite のデータベースにまとめられた。
Node.js を 24 に替えると、同じ pnpm install が通った。
警告が求める版は 22.13 以上で、リリースノートの「22 以上」より細かい。
CI のイメージ、.nvmrc、setup-node の版を先に 22.13 以上に上げてから、pnpm を 11 にする。
.npmrc に書いた pnpm の設定が読まれなくなった
11 が .npmrc から読むのは、認証とレジストリの設定になった。
リリースノートによると、httpProxy・strictSsl などのネットワークの設定も引き続き .npmrc から読まれる。shamefully-hoist・node-linker・hoist-pattern などは、pnpm-workspace.yaml にキャメルケースの名前で書く。
ここでは .npmrc に shamefully-hoist=true を書き、package.json に書いていない is-number(is-odd の依存)を require している。
v10 では
$ cat .npmrc
shamefully-hoist=true$ cat index.js
// is-number は is-odd の依存で、package.json には書いていない。
const isNumber = require("is-number");
console.log(isNumber(5));$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Progress: resolved 2, reused 2, downloaded 0, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 416ms using pnpm v10.34.9
$ echo $?
0$ pnpm config get shamefullyHoist
true$ node index.js
true
$ echo $?
0v11 に上げると
$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 2, reused 2, downloaded 0, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 363ms using pnpm v11.28.11
$ echo $?
0$ pnpm config get shamefullyHoist
undefined$ node index.js
node:internal/modules/cjs/loader:1568
throw err;
^
Error: Cannot find module 'is-number'
Require stack:
- /work/v11/npmrc-settings/index.js
at Module._resolveFilename (node:internal/modules/cjs/loader:1564:15)
at wrapResolveFilename (node:internal/modules/cjs/loader:1118:27)
at defaultResolveImplForCJSLoading (node:internal/modules/cjs/loader:1142:10)
at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1169:12)
at Module._load (node:internal/modules/cjs/loader:1341:5)
at wrapModuleLoad (node:internal/modules/cjs/loader:261:19)
at Module.require (node:internal/modules/cjs/loader:1674:12)
at require (node:internal/modules/helpers:157:16)
at Object.<anonymous> (/work/v11/npmrc-settings/index.js:2:18)
at Module._compile (node:internal/modules/cjs/loader:1929:14) {
code: 'MODULE_NOT_FOUND',
requireStack: [ '/work/v11/npmrc-settings/index.js' ]
}
Node.js v24.22.2
$ echo $?
1v11 で直すと
$ rm .npmrc$ cat pnpm-workspace.yaml
shamefullyHoist: true$ pnpm install
[ERR_PNPM_ABORTED_REMOVE_MODULES_DIR_NO_TTY] Aborted removal of modules directory due to no TTY
If you are running pnpm in CI, set the CI environment variable to "true", or set "confirmModulesPurge" to "false".
$ echo $?
1$ rm -rf node_modules$ pnpm install
✓ Lockfile passes supply-chain policies (verified 947ms ago)
Lockfile is up to date, resolution step is skipped
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 2, reused 2, downloaded 0, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 365ms using pnpm v11.28.11
$ echo $?
0$ pnpm config get shamefullyHoist
true$ node index.js
true
$ echo $?
011 は警告を出さずに install を終え、pnpm config get shamefullyHoist は undefined を返した。.npmrc の 1 行が読まれず、node index.js は Cannot find module 'is-number' で止まった。
依存の依存を require しているコードは、10 では shamefully-hoist のおかげで動いていただけである。
設定を pnpm-workspace.yaml に移すと、pnpm config get は true を返し、node index.js は通った。node_modules を残したまま pnpm install を打つと、11 は node_modules を作り直そうとして、端末が無いので止まった(ERR_PNPM_ABORTED_REMOVE_MODULES_DIR_NO_TTY)。
エラー文は、CI なら環境変数 CI を true にするか、confirmModulesPurge を false にするよう案内している。
ここでは node_modules を消してから入れ直した。
.npmrc には、トークンなどの認証とレジストリの行と、プロキシなどのネットワークの行を残す。
公式の移行ガイドは、ワークスペースの中のパッケージごとの .npmrc を pnpm-workspace.yaml の packageConfigs に移すよう書いている。
同じガイドによると、Docker のイメージで pnpm install するなら、その前に pnpm-workspace.yaml も COPY しておく。
package.json の pnpm フィールドが読まれなくなった
10 は package.json の "pnpm" フィールドから、overrides・patchedDependencies・onlyBuiltDependencies などの設定を読んでいた。
11 はこのフィールドを読まない。
ここでは overrides で is-number を 7.0.0 に固定し、10 で作った pnpm-lock.yaml をコミットしたリポジトリを、11 のディレクトリに clone して打った。
v10 では
$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"is-odd": "3.0.1"
},
"pnpm": {
"overrides": {
"is-number": "7.0.0"
}
}
}$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Progress: resolved 2, reused 1, downloaded 1, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 349ms using pnpm v10.34.9
$ echo $?
0$ pnpm list --depth 1
Legend: production dependency, optional only, dev only
app@1.0.0 /work/v10/pnpm-field (PRIVATE)
│
│ dependencies:
└─┬ is-odd@3.0.1
└── is-number@7.0.0
2 packagesv11 に上げると
$ pnpm install --frozen-lockfile
[WARN] The "pnpm" field in package.json is no longer read by pnpm. The following keys were ignored: "pnpm.overrides". See https://pnpm.io/settings for the new home of each setting.
? Verifying lockfile against supply-chain policies (2 entries)...
✓ Lockfile passes supply-chain policies (2 entries in 125ms)
[ERR_PNPM_LOCKFILE_CONFIG_MISMATCH] Cannot proceed with the frozen installation. The current "overrides" configuration doesn't match the value found in the lockfile
Update your lockfile using "pnpm install --no-frozen-lockfile"
$ echo $?
1$ pnpm install
[WARN] The "pnpm" field in package.json is no longer read by pnpm. The following keys were ignored: "pnpm.overrides". See https://pnpm.io/settings for the new home of each setting.
✓ Lockfile passes supply-chain policies (verified 320ms ago)
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 2, reused 2, downloaded 0, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 414ms using pnpm v11.28.11
$ echo $?
0$ pnpm list --depth 1
[WARN] The "pnpm" field in package.json is no longer read by pnpm. The following keys were ignored: "pnpm.overrides". See https://pnpm.io/settings for the new home of each setting.
Legend: production dependency, optional only, dev only
app@1.0.0 /work/v11/pnpm-field (PRIVATE)
│
│ dependencies:
└─┬ is-odd@3.0.1
└── is-number@6.0.0
2 packages$ git diff pnpm-lock.yaml
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 347966f..f805ef8 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -4,9 +4,6 @@ settings:
autoInstallPeers: true
excludeLinksFromLockfile: false
-overrides:
- is-number: 7.0.0
-
importers:
.:
@@ -17,9 +14,9 @@ importers:
packages:
- is-number@7.0.0:
- resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
- engines: {node: '>=0.12.0'}
+ is-number@6.0.0:
+ resolution: {integrity: sha512-Wu1VHeILBK8KAWJUAiSZQX94GmOE45Rg6/538fKwiloUu21KncEkYGPqob2oSZ5mUT73vLGrHQjKw3KMPwfDzg==}
+ engines: {node: '>=0.10.0'}
is-odd@3.0.1:
resolution: {integrity: sha512-CQpnWPrDwmP1+SMHXZhtLtJv90yiyVfluGsX5iNCVkrhQtU3TQHsUWPG9wkdk9Lgd5yNpAg9jQEo90CBaXgWMA==}
@@ -27,8 +24,8 @@ packages:
snapshots:
- is-number@7.0.0: {}
+ is-number@6.0.0: {}
is-odd@3.0.1:
dependencies:
- is-number: 7.0.0
+ is-number: 6.0.0v11 で直すと
$ git checkout pnpm-lock.yaml
Updated 1 path from the index$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"is-odd": "3.0.1"
}
}$ cat pnpm-workspace.yaml
overrides:
is-number: 7.0.0$ pnpm install --frozen-lockfile
✓ Lockfile passes supply-chain policies (verified 1s ago)
Lockfile is up to date, resolution step is skipped
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2 -1
++-
Progress: resolved 2, reused 1, downloaded 1, added 1, done
Done in 493ms using pnpm v11.28.11
$ echo $?
0$ pnpm list --depth 1
Legend: production dependency, optional only, dev only
app@1.0.0 /work/v11/pnpm-field (PRIVATE)
│
│ dependencies:
└─┬ is-odd@3.0.1
└── is-number@7.0.0
2 packages11 は "pnpm" フィールドを読まないと警告した。--frozen-lockfile では、ロックファイルに残る overrides と今の設定が合わないとして、ERR_PNPM_LOCKFILE_CONFIG_MISMATCH で止まった。pnpm install のドキュメントによると、CI ではロックファイルがあれば --frozen-lockfile が既定で有効になるので、CI の install はこのエラーで止まる。
--frozen-lockfile を付けない pnpm install は、警告を出すだけで通った。git diff のとおり、ロックファイルから overrides が消え、is-number は 6.0.0 に戻っている。overrides で古い版や脆弱性のある版を避けていたなら、手元の install でその固定が外れる。
"pnpm" フィールドを消し、同じ中身を pnpm-workspace.yaml に書くと、10 が書いたロックファイルのまま --frozen-lockfile が通った。is-number も 7.0.0 に戻った。patchedDependencies や packageExtensions も同じ名前で pnpm-workspace.yaml に書くが、ビルドスクリプトの設定は後の節の allowBuilds に書き換える。
許可していないビルドスクリプトで install が失敗するようになった
依存の postinstall などのビルドスクリプトは、10 でも許可したものだけが走る。
10 は許可していないスクリプトを飛ばして警告を出し、install は成功していた。
11 は strictDepBuilds の既定を true に変え、同じ場面で install を失敗させる。
v10 では
$ pnpm add esbuild@0.25.0
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Progress: resolved 26, reused 0, downloaded 2, added 2, done
dependencies:
+ esbuild 0.25.0 (0.28.2 is available)
╭ Warning ─────────────────────────────────────────────────────────────────────╮
│ │
│ Ignored build scripts: esbuild@0.25.0. │
│ Run "pnpm approve-builds" to pick which dependencies should be allowed │
│ to run scripts. │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
Done in 949ms using pnpm v10.34.9
$ echo $?
0v11 に上げると
$ pnpm add esbuild@0.25.0
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Packages are copied from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 26, reused 0, downloaded 2, added 2, done
dependencies:
+ esbuild 0.25.0 (0.28.2 is available)
[ERR_PNPM_IGNORED_BUILDS] Ignored build scripts: esbuild@0.25.0
Run "pnpm approve-builds" to pick which dependencies should be allowed to run scripts.
$ echo $?
1$ ls
node_modules
package.json
pnpm-lock.yamlv11 で直すと
$ pnpm approve-builds esbuild
.../esbuild@0.25.0/node_modules/esbuild postinstall$ node install.js
.../esbuild@0.25.0/node_modules/esbuild postinstall: Done
$ echo $?
0$ cat pnpm-workspace.yaml
allowBuilds:
esbuild: true$ pnpm install
✓ Lockfile passes supply-chain policies (verified 838ms ago)
Lockfile is up to date, resolution step is skipped
Already up to date
Done in 496ms using pnpm v11.28.11
$ echo $?
010 は枠で囲んだ警告を出して終了コード 0 を返し、11 は ERR_PNPM_IGNORED_BUILDS で 1 を返した。
11 でも依存は入っていて、ls に node_modules とロックファイルが見える。
CI はこの終了コードで止まる。
ドキュメントは、許可していない依存を install が pnpm-workspace.yaml の allowBuilds に仮の値で書き足すと書いている。
11.28.11 は pnpm-workspace.yaml を作らず、次の節で既にあるファイルも書き換えなかった。
11 の pnpm approve-builds は、許可する名前を引数で受け取る。pnpm approve-builds esbuild を打つと esbuild の postinstall が走り、pnpm-workspace.yaml に allowBuilds が書かれた。
ドキュメントによると、走らせたくない依存は false で書き、strictDepBuilds: false を書けば 10 と同じく警告で済む。
onlyBuiltDependencies などが allowBuilds にまとまった
ビルドを許可する onlyBuiltDependencies、禁止する neverBuiltDependencies、警告を消す ignoredBuiltDependencies は 11 で無くなった。onlyBuiltDependenciesFile と ignoreDepScripts も無くなり、どれも allowBuilds の 1 つにまとまった。
ここでは 10 の pnpm-workspace.yaml に onlyBuiltDependencies で esbuild を許可している。
v10 では
$ cat pnpm-workspace.yaml
onlyBuiltDependencies:
- esbuild$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Progress: resolved 26, reused 2, downloaded 0, added 2, done
.../esbuild@0.25.0/node_modules/esbuild postinstall$ node install.js
.../esbuild@0.25.0/node_modules/esbuild postinstall: Done
dependencies:
+ esbuild 0.25.0 (0.28.2 is available)
Done in 531ms using pnpm v10.34.9
$ echo $?
0v11 に上げると
$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Packages are copied from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 26, reused 2, downloaded 0, added 2, done
dependencies:
+ esbuild 0.25.0 (0.28.2 is available)
[ERR_PNPM_IGNORED_BUILDS] Ignored build scripts: esbuild@0.25.0
Run "pnpm approve-builds" to pick which dependencies should be allowed to run scripts.
$ echo $?
1$ cat pnpm-workspace.yaml
onlyBuiltDependencies:
- esbuildv11 で直すと
$ cat pnpm-workspace.yaml
allowBuilds:
esbuild: true$ pnpm install
✓ Lockfile passes supply-chain policies (verified 340ms ago)
Lockfile is up to date, resolution step is skipped
Already up to date
.../esbuild@0.25.0/node_modules/esbuild postinstall$ node install.js
.../esbuild@0.25.0/node_modules/esbuild postinstall: Done
Done in 508ms using pnpm v11.28.11
$ echo $?
011 は onlyBuiltDependencies を読まずに、esbuild を許可していないものとして扱った。
前の節と同じ ERR_PNPM_IGNORED_BUILDS で止まり、無くなった設定についての警告は出なかった。
allowBuilds に esbuild: true と書くと、esbuild の postinstall が走った。allowBuilds は名前と真偽値の対応で、11.0.0 のリリースノートは次の書き換えを例に挙げている。
| 10 の書き方 | 11 の allowBuilds |
|---|---|
onlyBuiltDependencies に electron | electron: true |
neverBuiltDependencies に core-js | core-js: false |
ignoredBuiltDependencies に esbuild | esbuild: false |
これらを package.json の "pnpm" フィールドに書いていた場合も、「package.json の pnpm フィールドが読まれなくなった」の節のとおり 11 は読まない。pnpm-workspace.yaml の allowBuilds に書き直す。
公開から 1 日たっていない版を入れなくなった
minimumReleaseAge は、公開から何分たった版なら入れてよいかを決める設定である。
10 の既定は 0 で、11 は 1440(1 日)にした。
リリースノートによると、改ざんされた版が見つかって消されるまでの時間を稼ぐための既定である。
TypeScript の nightly(next タグ)は毎日公開されるので、next が指す版は公開から 1 日たっていない。
v10 では
$ pnpm add -D typescript@next
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Progress: resolved 8, reused 0, downloaded 1, added 1
Progress: resolved 8, reused 0, downloaded 2, added 2, done
devDependencies:
+ typescript 7.1.0-dev.20261107.1
Done in 1.5s using pnpm v10.34.9
$ echo $?
0v11 に上げると
$ pnpm add -D typescript@next
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 8, reused 0, downloaded 1, added 1
Progress: resolved 8, reused 0, downloaded 2, added 2, done
devDependencies:
+ typescript 7.1.0-dev.20261106.1
Done in 2.1s using pnpm v11.28.11
$ echo $?
0$ pnpm list --depth 1
Legend: production dependency, optional only, dev only
app@1.0.0 /work/v11/minimum-release-age (PRIVATE)
│
│ devDependencies:
└─┬ typescript@7.1.0-dev.20261106.1
├── @typescript/typescript-darwin-arm64@7.1.0-dev.20261106.1
├── @typescript/typescript-darwin-x64@7.1.0-dev.20261106.1
├── @typescript/typescript-linux-arm@7.1.0-dev.20261106.1
├── @typescript/typescript-linux-arm64@7.1.0-dev.20261106.1
├── @typescript/typescript-linux-x64@7.1.0-dev.20261106.1
├── @typescript/typescript-win32-arm64@7.1.0-dev.20261106.1
└── @typescript/typescript-win32-x64@7.1.0-dev.20261106.1
8 packages$ npm view typescript time --json | tail -n 3
"7.1.0-dev.20261106.1": "2026-11-06T08:09:36.270Z",
"7.1.0-dev.20261107.1": "2026-11-07T08:11:06.869Z"
}$ date -u +%Y-%m-%dT%H:%M:%SZ
2026-11-07T09:28:03Zv11 で直すと
$ cat pnpm-workspace.yaml
minimumReleaseAgeExclude:
- typescript
- "@typescript/*"$ pnpm add -D typescript@next
? Verifying lockfile against supply-chain policies (8 entries)...
✓ Lockfile passes supply-chain policies (8 entries in 3ms)
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2 -2
++--
Progress: resolved 8, reused 0, downloaded 1, added 1
Progress: resolved 8, reused 0, downloaded 2, added 2, done
devDependencies:
- typescript 7.1.0-dev.20261106.1
+ typescript 7.1.0-dev.20261107.1
Done in 1.5s using pnpm v11.28.11
$ echo $?
010 は next が指す最新の nightly を入れ、11 はその 1 つ前の nightly を入れた。
どちらも終了コードは 0 で、11 は古い版を選んだことを知らせない。npm view の公開時刻と打った時刻を比べると、11 が避けた版は公開から 1 日たっていない。
minimumReleaseAgeExclude に名前を書くと、その依存だけは待たずに入る。pnpm list のとおり、TypeScript 7 の nightly は OS ごとの @typescript/typescript-* を同じ版で依存に持つので、@typescript/* も並べた。
直したあとの 11 は、10 と同じ最新の nightly を入れた。
11.0.0 のリリースノートによると、すべての依存で待つのをやめるなら pnpm-workspace.yaml に minimumReleaseAge: 0 と書く。minimumReleaseAge を自分で書くと minimumReleaseAgeStrict の既定が true になり、条件を満たす版が無い依存は resolution で失敗する。
既定の 1440 のままなら、条件を満たす版が無いときは新しい版で入れる。
範囲の中に古い版があれば、公開したばかりの修正版は 1 日選ばれないので、自分のパッケージや急ぎの修正は minimumReleaseAgeExclude に書く。
npm_config_ で始まる環境変数を読まなくなった
10 は npm と同じく、npm_config_ で始まる環境変数から設定を読んでいた。
11 はこれを読まず、pnpm_config_ で始まる環境変数を読む。
ここでは CI や Dockerfile で使われる NPM_CONFIG_REGISTRY でレジストリを渡し、pnpm が使う値を pnpm config get registry で見た。
v10 では
$ pnpm config get registry
https://registry.npmjs.org/$ NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ pnpm config get registry
https://registry.npmmirror.com/v11 に上げると
$ NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ pnpm config get registry
https://registry.npmjs.org/v11 で直すと
$ PNPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ pnpm config get registry
https://registry.npmmirror.com/11 は NPM_CONFIG_REGISTRY を読まず、既定の https://registry.npmjs.org/ を返した。
社内のミラーやプライベートのレジストリをこの変数で渡していると、11 が使うレジストリは npm の公開レジストリに戻る。
名前の頭を PNPM_CONFIG_ に替えると、11 は渡した値を返した。
リリースノートの例は小文字の pnpm_config_registry で、大文字の PNPM_CONFIG_REGISTRY でも読まれた。
リリースノートによると、レジストリの URL は 11 でも .npmrc の registry= から読まれる。
11 は、ライフサイクルスクリプトに pnpm の設定を npm_config_* として渡すこともやめた。
スクリプトの中でそれを読んでいたなら直す。
peer 依存の問題の一覧が pnpm peers check に移った
peer 依存は、使う側が入れておく前提の依存である。
範囲に合わない版が入っていると、10 は install の出力に問題の木を出していた。
11 の install は 1 行の警告で pnpm peers check を案内するだけになり、一覧はこの新しいコマンドで見る。
ここでは react 19 と、react 18 までを求める react-redux 8 を入れた。
v10 では
$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"react": "19.2.0",
"react-redux": "8.1.3"
}
}$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +12
++++++++++++
Progress: resolved 12, reused 0, downloaded 12, added 12, done
WARN Issues with peer dependencies found
.
└─┬ react-redux 8.1.3
└── ✕ unmet peer react@"^16.8 || ^17.0 || ^18.0": found 19.2.0
dependencies:
+ react 19.2.0 (19.3.1 is available)
+ react-redux 8.1.3 (9.3.1 is available)
Done in 906ms using pnpm v10.34.9
$ echo $?
0v11 に上げると
$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +12
++++++++++++
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 12, reused 0, downloaded 11, added 8
Progress: resolved 12, reused 0, downloaded 12, added 12, done
[WARN] Issues with peer dependencies found. Run "pnpm peers check" to list them.
dependencies:
+ react 19.2.0 (19.3.1 is available)
+ react-redux 8.1.3 (9.3.1 is available)
Done in 1.4s using pnpm v11.28.11
$ echo $?
0v11 で直すと
$ pnpm peers check
Issues with peer dependencies found
✕ unmet peer react
Installed: 19.2.0
Wanted:
"^16.8 || ^17.0 || ^18.0":
react-redux@8.1.3
$ echo $?
1$ pnpm add react-redux@9.2.0
✓ Lockfile passes supply-chain policies (verified 639ms ago)
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2 -7
++-------
Progress: resolved 7, reused 5, downloaded 2, added 2, done
dependencies:
- react-redux 8.1.3
+ react-redux 9.2.0 (9.3.1 is available)
Done in 863ms using pnpm v11.28.11
$ echo $?
0$ pnpm peers check
No peer dependency issues found
$ echo $?
011 の install の出力には react-redux の名前が出ず、どちらの版も終了コードは 0 だった。
CI のログで peer の食い違いを見ていたなら、11 では見えなくなる。
pnpm peers check を打つと、10 の木と同じ中身が一覧で出て、終了コード 1 を返した。
react-redux を 9.2.0 に上げると問題が無くなり、pnpm peers check は 0 を返した。
CI で peer の食い違いを止めたいなら、install のあとに pnpm peers check を足す。
pnpm init が "type": "module" を書くようになった
11 の pnpm init は、package.json に "type": "module" を書く。
同じディレクトリの .js は ES モジュールとして読まれ、require を使うファイルが動かなくなる。
v10 では
$ pnpm init
Wrote to /work/v10/init-type-module/package.json
{
"name": "init-type-module",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": [],
"author": "",
"license": "ISC",
"packageManager": "pnpm@10.34.9"
}
$ echo $?
0$ cat index.js
const { readFileSync } = require("node:fs");
const pkg = JSON.parse(readFileSync("package.json", "utf8"));
console.log(`${pkg.name}@${pkg.version}`);$ node index.js
init-type-module@1.0.0
$ echo $?
0v11 に上げると
$ pnpm init
Wrote to /work/v11/init-type-module/package.json
{
"name": "init-type-module",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": [],
"author": "",
"license": "ISC",
"devEngines": {
"packageManager": {
"name": "pnpm",
"version": "12.18.0",
"onFail": "download"
}
},
"packageManager": "pnpm@12.18.0",
"type": "module"
}
$ echo $?
0$ node index.js
file:///work/v11/init-type-module/index.js:1
const { readFileSync } = require("node:fs");
^
ReferenceError: require is not defined in ES module scope, you can use import instead
This file is being treated as an ES module because it has a '.js' file extension and '/work/v11/init-type-module/package.json' contains "type": "module". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.
at file:///work/v11/init-type-module/index.js:1:26
at ModuleJob.run (node:internal/modules/esm/module_job:561:25)
at async node:internal/modules/esm/loader:647:26
at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:101:5)
Node.js v24.22.2
$ echo $?
1$ pnpm --version
12.18.0v11 で直すと
$ cat index.js
import { readFileSync } from "node:fs";
const pkg = JSON.parse(readFileSync("package.json", "utf8"));
console.log(`${pkg.name}@${pkg.version}`);$ node index.js
init-type-module@1.0.0
$ echo $?
011 で作った package.json には "type": "module" が入り、node index.js は require is not defined in ES module scope で止まった。require を import に書き換えると動いた。
ドキュメントによると、CommonJS のまま作るなら pnpm init --init-type commonjs を打つ。
Node.js のエラー文のとおり、ファイルを .cjs にしてもよい。
もう 1 つの違いとして、11.28.11 は devEngines.packageManager と packageManager に 12.18.0 を書いた。
11.25.0 のリリースノートによると、pnpm init は動いている pnpm の版ではなく、latest の版を固定するようになった。latest のほうが古ければ、動いている版を固定する。
打った時点の latest は 12 系で、このディレクトリの pnpm --version は 12.18.0 を返した。
11 のまま使うなら固定した版を書き換えるか、--no-init-package-manager を付けて固定せずに作る。
検証環境Node.js 24.22.2 / npm 11.19.1 / Python 3.11.2 / 2026-11-07 検証(ほか 4 件)
- 検証日
- 実行環境
node:24Debian GNU/Linux 12 (bookworm)- バージョン
- Node.js 24.22.2
- npm 11.19.1
- Python 3.11.2
- Git 2.39.5
- pnpm(旧) 10.34.9
- pnpm(新) 11.28.11
- Node.js(最初の節の v10・v11 の段) 20.20.2
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。