npm を 11 から 12 に上げると動かなくなること
npm を 11 から 12 に上げると、依存の install スクリプトは許可しないと走らず、git や URL で書いた依存は入らなくなる。
知らないフラグと省略したフラグはエラーになり、Node.js 20 では 12 に上げられない。
11.21 と 12.2 で打ち比べた 10 の変更点と直し方をまとめる。
公開:
node:24 のイメージに入っていた npm 11.19.1 で npm@11 と npm@12 を別の場所に入れ、段ごとに PATH を差し替えて呼び分けた。
どちらの npm が動いたかは、各段の最初の npm --version に出ている。
各節の出力は「v11 では」「v12 に上げると」「v12 で直すと」の 3 段で並ぶ。
旧版は 11.21.2、新版は 12.2.2 である。
12 の engines.node は ^22.22.2 || ^24.15.0 || >=26.0.0 で、最初の節の最後に npm view で出している。
node:24 の Node.js 24.22.3 はこの範囲に入るので、イメージは node:24 のまま使った。
最初の節の v11・v12 の段だけ、Node.js を 20.20.2 に替えている。
ロックファイルを使う節では、11 で作ったプロジェクトを git でコミットし、12 のディレクトリに clone してから打った。
手元は 11 のまま、CI のイメージだけが先に 12 になった場面に当たる。
動かなくなる原因は 3 つに分かれる。
1 つ目は install の既定を安全側に倒したことで、依存の install スクリプトは許可しないと走らず、git と URL の依存は入らない。
2 つ目は削除である。
11 が「次のメジャーで動かなくなる」と警告していた知らないフラグと省略したフラグは、エラーになった。npm-shrinkwrap.json は 11 では警告なしに使えていたが、12 では読まれない。
3 つ目は順序と出力の変化で、ルートの preinstall が依存より先に走り、npm pkg get と npm view --json の出力の形が変わった。
GitHub の予告の記事は、install の既定の 3 つの変更(スクリプト・git・URL)は、どれも 11.16.0 以降で警告になると書いている。
11.21.2 が警告を出したのは install スクリプトの節だけで、git と URL の依存は何も言わずに入った。
11 で警告が出ないことは、12 で通る理由にならない。
次の変更は、このページでは打っていない。
npm adduserは無くなった。
アカウントは npm のサイトで作り、コマンドラインではnpm loginを使う。npm star・npm stars・npm unstarは無くなった。npm initの既定のライセンスがISCから空になり、指定しなければlicenseの項目を書かない。- global に入れたとき、man のページを登録しなくなった。
man npm-installは使えなくなり、npm help installは使える。 npm pack --jsonとnpm publish --jsonの出力の形が変わり、2 つで同じ形になった。npm sbom --sbom-format=cyclonedxは、各パッケージの名前をpackage.jsonのnameから取るようになった。- npm は
process.execPathを、PATH から探した node のパスで上書きしなくなった。 npm install -gとnpxで入れるパッケージは、書き込むpackage.jsonが無いので、install スクリプトを--allow-scripts=<名前>で許可する(npm install-scriptsのドキュメント)。- 設定のドキュメントによると、プロジェクトの中で打つ
npm install・npm ci・npm update・npm rebuildに--allow-scriptsを付けるとエラーになる。
プロジェクトではpackage.jsonのallowScriptsに書く。 - 2026-07-08 の GitHub の記事によると、暗黙の node-gyp のビルドも許可しないと走らない。
予告の記事は、installスクリプトを書かずにbinding.gypだけを持つパッケージを例に挙げている。
ほかの変更も含めた一覧は 12.0.0 のリリースノート(新しいタブで開く) にある。
Node.js 20 では npm 12 に上げられない
12.0.0 のリリースノートは、対応する Node.js を ^22.22.2 || ^24.15.0 || >=26.0.0 にしたと書いている。
Node.js 20 は対象から外れ、22.22.2 より前の 22 系と、24.15.0 より前の 24 系も範囲に入らない。
ここでは Node.js 20.20.2 と npm 11.21.2 の組で、npm install -g npm@12 を打った。
v11 では
$ node --version
v20.20.2$ npm --version
11.21.2$ npm install
added 2 packages in 572ms
$ echo $?
0v12 に上げると
$ npm install -g npm@12
npm error code EBADENGINE
npm error engine Unsupported engine
npm error engine Not compatible with your version of node/npm: npm@12.2.2
npm error notsup Not compatible with your version of node/npm: npm@12.2.2
npm error notsup Required: {"node":"^22.22.2 || ^24.15.0 || >=26.0.0"}
npm error notsup Actual: {"node":"v20.20.2","npm":"11.21.2"}
npm error A complete log of this run can be found in: /root/.npm/_logs/2026-11-13T01_45_08_473Z-debug-0.log
$ echo $?
1$ npm --version
11.21.2$ npx -y npm@12 install
npm warn EBADENGINE Unsupported engine {
npm warn EBADENGINE package: 'npm@12.2.2',
npm warn EBADENGINE required: { node: '^22.22.2 || ^24.15.0 || >=26.0.0' },
npm warn EBADENGINE current: { node: 'v20.20.2', npm: '11.21.2' }
npm warn EBADENGINE }
npm warn cli npm v12.2.2 does not support Node.js v20.20.2. This version of npm supports the following node versions: `^22.22.2 || ^24.15.0 || >=26.0.0`. You can find the latest version at https://nodejs.org/.
added 2 packages in 225ms
$ echo $?
0v12 で直すと
$ node --version
v24.22.3$ npm --version
11.21.2$ npm install -g npm@12
added 1 package in 2s
$ echo $?
0$ npm --version
12.2.2$ npm install
up to date in 209ms
$ echo $?
0$ npm view npm@12.2.2 engines.node
^22.22.2 || ^24.15.0 || >=26.0.011 は npm 12 の engines を見て、global の npm の入れ替えを EBADENGINE のエラーで止めた。
そのあとの npm --version は 11.21.2 のままである。npx で 12 を動かすと、EBADENGINE の警告に続けて、12 自身が Node.js v20.20.2 には対応していないと警告した。
この npm install は終了コード 0 で通ったが、12 が対応の外とした組み合わせで動かしている。
Node.js を 24.22.3 に替えると、同じ npm 11.21.2 からの npm install -g npm@12 が通り、npm --version は 12.2.2 になった。
続く npm install も警告を出さずに通った。
22 系なら 22.22.2 以上、24 系なら 24.15.0 以上が要る。
CI のイメージ、.nvmrc、setup-node の版を先にこの範囲へ上げてから、npm を 12 にする。
依存の install スクリプトが許可しないと走らなくなった
12.0.0 のリリースノートによると、依存の lifecycle スクリプトは、ルートの package.json の allowScripts で許可しないと走らない。npm install-scripts のドキュメントによると、対象は preinstall・install・postinstall と、レジストリ以外から入れた依存の prepare である。
ここでは better-sqlite3 を入れた。
better-sqlite3 は install スクリプトで、Node.js から読み込むネイティブのモジュールを用意する。
v11 では
$ npm --version
11.21.2$ cat index.js
const Database = require("better-sqlite3");
const db = new Database(":memory:");
console.log(db.prepare("select sqlite_version() as version").get());$ npm install better-sqlite3@12.11.1
npm warn deprecated prebuild-install@7.1.3: No longer maintained. Please contact the author of the relevant native addon; alternatives are available.
added 38 packages in 2s
npm warn install-scripts 1 package has install scripts not yet covered by allowScripts:
npm warn install-scripts better-sqlite3@12.11.1 (install: prebuild-install || node-gyp rebuild --release)
npm warn install-scripts
npm warn install-scripts Run `npm install-scripts ls` to review, or `npm install-scripts approve <pkg>` to allow.
$ echo $?
0$ node index.js
{ version: '3.53.2' }
$ echo $?
0v12 に上げると
$ npm --version
12.2.2$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"better-sqlite3": "^12.11.1"
}
}$ npm ci
npm warn deprecated prebuild-install@7.1.3: No longer maintained. Please contact the author of the relevant native addon; alternatives are available.
added 38 packages in 394ms
npm warn install-scripts 1 package had install scripts blocked because they are not covered by allowScripts:
npm warn install-scripts better-sqlite3@12.11.1 (install: prebuild-install || node-gyp rebuild --release)
npm warn install-scripts
npm warn install-scripts Run `npm install-scripts ls` to review, or `npm install-scripts approve <pkg>` to allow.
$ echo $?
0$ node index.js
/work/v12/install-scripts/node_modules/bindings/bindings.js:135
throw err;
^
Error: Could not locate the bindings file. Tried:
→ /work/v12/install-scripts/node_modules/better-sqlite3/build/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/build/Debug/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/build/Release/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/out/Debug/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/Debug/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/out/Release/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/Release/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/build/default/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/compiled/24.22.3/linux/x64/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/addon-build/release/install-root/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/addon-build/debug/install-root/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/addon-build/default/install-root/better_sqlite3.node
→ /work/v12/install-scripts/node_modules/better-sqlite3/lib/binding/node-v137-linux-x64/better_sqlite3.node
at bindings (/work/v12/install-scripts/node_modules/bindings/bindings.js:126:9)
at new Database (/work/v12/install-scripts/node_modules/better-sqlite3/lib/database.js:48:64)
at Object.<anonymous> (/work/v12/install-scripts/index.js:3:12)
at Module._compile (node:internal/modules/cjs/loader:1929:14)
at Object..js (node:internal/modules/cjs/loader:2060:10)
at Module.load (node:internal/modules/cjs/loader:1651:32)
at Module._load (node:internal/modules/cjs/loader:1443:12)
at wrapModuleLoad (node:internal/modules/cjs/loader:261:19)
at Module.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:154:5)
at node:internal/main/run_main_module:33:47 {
tries: [
'/work/v12/install-scripts/node_modules/better-sqlite3/build/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/build/Debug/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/build/Release/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/out/Debug/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/Debug/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/out/Release/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/Release/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/build/default/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/compiled/24.22.3/linux/x64/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/addon-build/release/install-root/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/addon-build/debug/install-root/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/addon-build/default/install-root/better_sqlite3.node',
'/work/v12/install-scripts/node_modules/better-sqlite3/lib/binding/node-v137-linux-x64/better_sqlite3.node'
]
}
Node.js v24.22.3
$ echo $?
1v12 で直すと
$ npm install-scripts approve better-sqlite3
Approved better-sqlite3:
added better-sqlite3@12.11.1
$ echo $?
0$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"better-sqlite3": "^12.11.1"
},
"allowScripts": {
"better-sqlite3@12.11.1": true
}
}$ npm rebuild
rebuilt dependencies successfully
$ echo $?
0$ node index.js
{ version: '3.53.2' }
$ echo $?
0$ rm -rf node_modules$ npm ci
npm warn deprecated prebuild-install@7.1.3: No longer maintained. Please contact the author of the relevant native addon; alternatives are available.
added 38 packages in 423ms
$ echo $?
0$ node index.js
{ version: '3.53.2' }
$ echo $?
011.21.2 も install の最後に、allowScripts で許可していないスクリプトがあると警告した。
スクリプトは走り、node index.js は SQLite の版を返した。
12 の npm ci は同じ一覧を「blocked」として出し、終了コード 0 で終わった。
install は成功するので、CI はこの段では止まらない。
止まるのは依存を使う段である。node index.js は、ネイティブのモジュール(.node のファイル)が見つからないという Could not locate the bindings file で落ちた。
better-sqlite3 の場合、このファイルを用意するのが止められた install スクリプトである。
npm install-scripts approve better-sqlite3 を打つと、package.json に allowScripts が書かれた。
キーは better-sqlite3@12.11.1 で、入っている版に固定される。
止まっていたスクリプトは npm rebuild で走り、node index.js が通った。allowScripts を書いた package.json をコミットしておけば、node_modules を消したあとの npm ci でもスクリプトが走る。
ドキュメントによると、版を固定した許可はその版にしか効かない。
better-sqlite3 を上げたら、もう一度 npm install-scripts approve を打つ。
名前だけで許可するなら --no-allow-scripts-pin を付ける。
GitHub の予告の記事が案内する npm approve-scripts は、ドキュメントでは npm install-scripts approve の別名である。
git で書いた依存を入れなくなった
12.0.0 のリリースノートは、allow-git の既定を none にしたと書いている。github: や git+https: で書いた依存は入らない。
ここでは 11 で github:jonschlinkert/is-odd#3.0.1 を入れたプロジェクトをコミットし、12 のディレクトリに clone して npm ci を打った。
v11 では
$ npm --version
11.21.2$ npm install "github:jonschlinkert/is-odd#3.0.1"
added 2 packages in 2s
$ echo $?
0$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"is-odd": "github:jonschlinkert/is-odd#3.0.1"
}
}v12 に上げると
$ npm --version
12.2.2$ npm ci
npm error code EALLOWGIT
npm error Fetching packages of type "git" have been disabled
npm error Refusing to fetch "is-odd@git+ssh://git@github.com/jonschlinkert/is-odd.git#a80ee0d831a8ee69f1fad5b4673491847975eb26"
npm error A complete log of this run can be found in: /root/.npm/_logs/2026-11-13T01_45_19_908Z-debug-0.log
$ echo $?
1v12 で直すと
$ cat .npmrc
allow-git=root$ npm ci
added 2 packages in 420ms
$ echo $?
0$ npm ls
app@1.0.0 /work/v12/allow-git
`-- is-odd@3.0.1 (git+ssh://git@github.com/jonschlinkert/is-odd.git#a80ee0d831a8ee69f1fad5b4673491847975eb26)
$ echo $?
011 は警告を出さずに git の依存を入れた。
12 は EALLOWGIT で止まり、git の種類のパッケージの取得は無効になっていると出した。
GitHub の予告の記事は、git の依存に含まれる .npmrc が git の実行ファイルを差し替えられる経路を塞ぐためだと書いている。
プロジェクトの .npmrc に allow-git=root を書くと、npm ci は通った。
設定のドキュメントによると、root はプロジェクトの package.json に書いた git の依存だけを許す。
GitHub の予告の記事は、止める対象を直接の依存と間接の依存の両方と書いている。root の定義のとおりなら、依存の依存に入った git の依存は root では許されない。
そうした依存があるなら、all にするか、その依存をレジストリの版に替える(このページでは、間接の git の依存は打っていない)。
同じドキュメントは、.npmrc に書く代わりに、コマンドに付けて 1 回だけ許す使い方も挙げている。
URL で書いた依存を入れなくなった
12.0.0 のリリースノートは、allow-remote の既定も none にしたと書いている。
tarball の URL で書いた依存は入らない。
SheetJS のドキュメントは、xlsx を https://cdn.sheetjs.com の tarball の URL で入れるよう案内しているので、それを使った。
v11 では
$ npm --version
11.21.2$ npm install https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz
added 1 package in 624ms
$ echo $?
0$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
}
}v12 に上げると
$ npm --version
12.2.2$ npm ci
npm error code EALLOWREMOTE
npm error Fetching packages of type "remote" have been disabled
npm error Refusing to fetch "xlsx@https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
npm error A complete log of this run can be found in: /root/.npm/_logs/2026-11-13T01_45_21_566Z-debug-0.log
$ echo $?
1$ npm install https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz
npm error code EALLOWREMOTE
npm error Fetching packages of type "remote" have been disabled
npm error Refusing to fetch "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz"
npm error A complete log of this run can be found in: /root/.npm/_logs/2026-11-13T01_45_21_743Z-debug-0.log
$ echo $?
1v12 で直すと
$ cat .npmrc
allow-remote=root$ npm ci
added 1 package in 221ms
$ echo $?
0$ npm ls
app@1.0.0 /work/v12/allow-remote
`-- xlsx@0.20.3
$ echo $?
011 は警告を出さずに URL の依存を入れた。
12 の npm ci は EALLOWREMOTE で止まった。
設定のドキュメントは、設定したレジストリと同じホストの tarball は今までどおり入ると書いている。
それでも npm install に registry.npmjs.org の tarball の URL を渡すと、同じ EALLOWREMOTE で止まった。
.npmrc に allow-remote=root を書くと、npm ci は通った。root の意味は allow-git と同じで、プロジェクトの package.json に書いた URL の依存だけを許す。
ルートの preinstall が依存を入れる前に走るようになった
12.0.0 のリリースノートは、ルートの preinstall を、依存を入れる前に走らせるようにしたと書いている。
ここではルートの preinstall で check.js を走らせ、check.js から依存の semver を require した。
v11 では
$ npm --version
11.21.2$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"scripts": {
"preinstall": "node check.js"
},
"dependencies": {
"semver": "7.7.2"
}
}$ cat check.js
const semver = require("semver");
console.log(`Node.js ${process.version} >= 22: ${semver.satisfies(process.version, ">=22")}`);$ npm install
> app@1.0.0 preinstall
> node check.js
Node.js v24.22.3 >= 22: true
added 1 package in 319ms
$ echo $?
0v12 に上げると
$ npm --version
12.2.2$ npm install
npm notice run app@1.0.0 preinstall
npm notice run node check.js
node:internal/modules/cjs/loader:1568
throw err;
^
Error: Cannot find module 'semver'
Require stack:
- /work/v12/preinstall-order/check.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/v12/preinstall-order/check.js:1:16)
at Module._compile (node:internal/modules/cjs/loader:1929:14) {
code: 'MODULE_NOT_FOUND',
requireStack: [ '/work/v12/preinstall-order/check.js' ]
}
Node.js v24.22.3
npm error code 1
npm error path /work/v12/preinstall-order
npm error command failed
npm error command sh -c node check.js
npm error A complete log of this run can be found in: /root/.npm/_logs/2026-11-13T01_45_22_827Z-debug-0.log
$ echo $?
1v12 で直すと
$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"scripts": {
"postinstall": "node check.js"
},
"dependencies": {
"semver": "7.7.2"
}
}$ npm install
npm notice run app@1.0.0 postinstall
npm notice run node check.js
Node.js v24.22.3 >= 22: true
added 1 package in 200ms
$ echo $?
011 は semver を入れたあとに preinstall を走らせたので、node_modules の無いところからの npm install でも check.js は通った。
12 は semver を入れる前に check.js を走らせ、Cannot find module 'semver' で止まった。
スクリプトを走らせる前の行は、11 の > app@1.0.0 preinstall から npm notice run app@1.0.0 preinstall に変わっている。
scripts のドキュメントは、入れた依存を使う処理は install か postinstall に書くよう案内している。preinstall を postinstall に替えると、semver を入れたあとに check.js が走って通った。
依存を入れる前に確かめたいことなら、check.js から依存を外し、Node.js の組み込みのモジュールだけで書く。
npm の設定に無いフラグがエラーになった
npm run build --env=production の --env は、npm の設定に無いフラグである。
11 は警告を出したうえで、値をスクリプトに環境変数 npm_config_env として渡していた。
12.0.0 のリリースノートは、知らないフラグを警告からエラーに変えたと書いている。
v11 では
$ npm --version
11.21.2$ cat build.js
console.log(`env=${process.env.npm_config_env}`);$ npm run build --env=production
npm warn Unknown cli config "--env". This will stop working in the next major version of npm.
> app@1.0.0 build
> node build.js
env=production
$ echo $?
0v12 に上げると
$ npm --version
12.2.2$ npm run build --env=production
npm error code EUNKNOWNCONFIG
npm error Unknown cli flag:
npm error - --env
npm error Run `npm help config` for supported options.
npm error A complete log of this run can be found in: /root/.npm/_logs/2026-11-13T01_45_23_473Z-debug-0.log
$ echo $?
1v12 で直すと
$ cat build.js
const { parseArgs } = require("node:util");
const { values } = parseArgs({ options: { env: { type: "string" } } });
console.log(`env=${values.env}`);$ npm run build -- --env=production
npm notice run app@1.0.0 build
npm notice run node build.js --env=production
env=production
$ echo $?
011 の警告は「次のメジャーで動かなくなる」と予告していた。
12 は EUNKNOWNCONFIG で止まり、build のスクリプトは走らなかった。
スクリプトに渡す引数は、-- のあとに書く。-- のあとの --env=production は node build.js の引数になるので、build.js は環境変数の代わりに process.argv から読む。
ここでは node:util の parseArgs で読み、env=production が出た。
リリースノートによると、.npmrc に書いた知らない設定は 12 でも警告で済む。
新しい設定の strict-npmrc を true にすると、こちらもエラーになる。
省略したフラグがエラーになった
11 は、省略したフラグを正式な名前に広げて動いていた。
12.0.0 のリリースノートは、省略したフラグと、1 つのハイフンに続けた複数文字の短縮形をエラーにしたと書いている。
ここでは devDependencies を入れない npm ci --prod を打った。
v11 では
$ npm --version
11.21.2$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"is-odd": "3.0.1"
},
"devDependencies": {
"left-pad": "1.3.0"
}
}$ npm ci --prod
npm warn Expanding --prod to --production. This will stop working in the next major version of npm.
npm warn config production Use `--omit=dev` instead.
added 2 packages in 143ms
$ echo $?
0$ ls node_modules
is-number
is-oddv12 に上げると
$ npm --version
12.2.2$ npm ci --prod
Exit prior to config file resolving
cause
Invalid abbreviated flag "--prod". Did you mean "--production"?
$ echo $?
1v12 で直すと
$ npm ci --omit=dev
added 2 packages in 172ms
$ echo $?
0$ ls node_modules
is-number
is-odd11 は --prod を --production に広げると警告し、--production についても --omit=dev を使うよう警告した。
devDependencies の left-pad は入っていない。
12 は Invalid abbreviated flag で止まり、正しい名前の候補として --production を出した。
このエラーは npm error で始まらず、前に Exit prior to config file resolving と cause の 2 行が付く。
候補の --production は、11 でも --omit=dev に替えるよう警告されていた。npm ci --omit=dev は 12 でも通り、入ったのは is-odd とその依存の is-number だけだった。
npm-shrinkwrap.json を読まなくなった
12.0.0 のリリースノートによると、npm shrinkwrap のコマンドが無くなった。npm-shrinkwrap.json は、プロジェクトのルートでも依存の tarball の中でも読まれない。
ここでは is-odd を ^3.0.0 で書き、npm shrinkwrap で 3.0.0 に固定したプロジェクトを 11 でコミットした。
v11 では
$ npm --version
11.21.2$ npm install is-odd@3.0.0
added 2 packages in 278ms
$ echo $?
0$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"is-odd": "^3.0.0"
}
}$ npm shrinkwrap
npm notice package-lock.json has been renamed to npm-shrinkwrap.json
$ echo $?
0$ ls
node_modules
npm-shrinkwrap.json
package.json$ rm -rf node_modules$ npm ci
added 2 packages in 157ms
$ echo $?
0$ npm ls
app@1.0.0 /work/v11/shrinkwrap
`-- is-odd@3.0.0v12 に上げると
$ npm --version
12.2.2$ ls
npm-shrinkwrap.json
package.json$ npm shrinkwrap
Unknown command: "shrinkwrap"
To see a list of supported npm commands, run:
npm help
$ echo $?
1$ npm ci 2>&1 | head -n 4
npm error code EUSAGE
npm error
npm error The `npm ci` command can only install with an existing
npm error package-lock.json with lockfileVersion >= 1. Run an install with npm@5$ npm install
added 2 packages in 175ms
$ echo $?
0$ npm ls
app@1.0.0 /work/v12/shrinkwrap
`-- is-odd@3.0.1$ ls
node_modules
npm-shrinkwrap.json
package-lock.json
package.jsonv12 で直すと
$ mv npm-shrinkwrap.json package-lock.json$ npm ci
added 2 packages in 159ms
$ echo $?
0$ npm ls
app@1.0.0 /work/v12/shrinkwrap
`-- is-odd@3.0.012 は npm shrinkwrap を知らないコマンドとして扱った。npm ci は、package-lock.json が無いとして EUSAGE で止まった。
このエラーには npm ci の使い方の説明が続くので、ここでは head で先頭の 4 行だけを出している。
npm install は通ったが、npm-shrinkwrap.json を読まずに依存を解き直し、is-odd は 3.0.1 になった。package-lock.json が新しくでき、npm-shrinkwrap.json もそのまま残っている。
リリースノートのとおり、npm-shrinkwrap.json を package-lock.json に名前を変えると、npm ci が通って is-odd は 3.0.0 に戻った。
公開するパッケージに依存の木を固定して同梱したいなら、リリースノートは bundleDependencies を使うよう書いている。
npm pkg get が JSON で出さなくなった
12.0.0 のリリースノートは、npm pkg の出力を JSON に固定するのをやめ、npm view に近い形で出すと書いている。
値を 1 つだけ取り出すときに、引用符を気にしなくてよくするためである。
v11 では
$ npm --version
11.21.2$ npm pkg get version
"1.0.0"$ npm pkg get name version
{
"name": "app",
"version": "1.0.0"
}v12 に上げると
$ npm --version
12.2.2$ npm pkg get version
1.0.0$ npm pkg get name version
name = 'app'
version = '1.0.0'v12 で直すと
$ npm pkg get name version --json
{
"name": "app",
"version": "1.0.0"
}$ npm pkg get version --json
{
"version": "1.0.0"
}11 の npm pkg get version は二重引用符の付いた "1.0.0" を出し、12 は 1.0.0 だけを出した。
キーを 2 つ渡すと、11 は JSON のオブジェクトを出し、12 は name = 'app' のような行を出した。
出力を JSON として読んでいた処理は、12 では読めなくなる。
JSON が要るときは --json を付ける。
キーが 2 つなら、11 と同じ形のオブジェクトが出た。
キーが 1 つでも { "version": "1.0.0" } のオブジェクトで返るので、11 の "1.0.0" とは形が違う。
値だけが要るなら、12 では --json を付けずに npm pkg get version を使う。
npm view --json が 1 つの値も配列で返すようになった
12.0.0 のリリースノートは、npm view --json がいつも配列を返すようにしたと書いている。
v11 では
$ npm --version
11.21.2$ npm view is-odd version --json
"3.0.1"$ npm view is-odd name version --json
{
"name": "is-odd",
"version": "3.0.1"
}$ npm view is-odd versions --json
[
"0.1.0",
"0.1.1",
"0.1.2",
"1.0.0",
"2.0.0",
"3.0.0",
"3.0.1"
]$ npm view is-odd version
3.0.1v12 に上げると
$ npm --version
12.2.2$ npm view is-odd version --json
[
"3.0.1"
]$ npm view is-odd name version --json
[
{
"name": "is-odd",
"version": "3.0.1"
}
]$ npm view is-odd versions --json
[
"0.1.0",
"0.1.1",
"0.1.2",
"1.0.0",
"2.0.0",
"3.0.0",
"3.0.1"
]v12 で直すと
$ npm view is-odd version
3.0.111 は値が 1 つなら "3.0.1" を返し、キーを 2 つ渡すとオブジェクトを返した。
12 はどちらも配列に入れて返した。--json の出力を文字列やオブジェクトとして読んでいた処理は、12 では配列の 1 つ目を取り出す。
値がもともと配列の versions は、11 と 12 で同じ形の配列が返った。
npm/cli の #9745 によると、12.0.0 は versions のような配列の値も外側の配列で包んでいて、12.0.1 で包まないように直された。
12.0.0 のまま使っているなら、versions も形が変わる。
値だけが要るなら --json を外す。npm view is-odd version は、11 でも 12 でも 3.0.1 を出した。
検証環境Node.js 24.22.3 / npm 11.19.1 / Python 3.11.2 / 2026-11-13 検証(ほか 4 件)
- 検証日
- 実行環境
node:24Debian GNU/Linux 12 (bookworm)- バージョン
- Node.js 24.22.3
- npm 11.19.1
- Python 3.11.2
- Git 2.39.5
- npm(旧) 11.21.2
- npm(新) 12.2.2
- Node.js(最初の節の v11・v12 の段) 20.20.2
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。