@npmcli/arborist
10.0.5 · 18 Nov 2026ISC9.7M / weekRepositoryHomepagenpmAtom feed
9.9.4 is the newest release of 9.x.
In short
17 breaking3 deprecated22 new8 fixed3 changed47 internal
- Breaking
npmis now compatible with the following semver range for node:^14.17.0 || ^16.13.0 || >=18.0.0 - Breaking
npmwill no longer attempt to modify ownership of files it creates - Breaking
The presence of auth related settings that are not scoped to a specific registry found in a config file is no longer supported and will throw errors
- Breaking
login,adduser, andauth-typechanges - Breaking
npm packnow follows a strict order of operations when applying ignore rules. If afilesarray is present in thepackage.json, then rules in.gitignoreand.npmignorefiles from the root will be ignored. - Breaking
Links generated from git urls will now use
HEADinstead ofmasteras the default ref - Breaking
timingandloglevelchanges - Breaking
npmnow outputs some json errors on stdout. Previouslynpmwould output all json formatted errors on stderr, making it difficult to parse as the stderr stream usually has logs already written to it. In the future,npmwill differentiate between errors and crashes. Errors, such asE404andERESOLVE, will be handled and will continue to be output on stdout. In the case of a crash,npmwill log the error as usual but will not attempt to display it as json, even in--jsonmode. Moving a case from the category of an error to a crash will not be considered a breaking change. For more information see npm/rfcs#482.
Release note
Breaking changes
- Breaking
npmis now compatible with the following semver range for node:^14.17.0 || ^16.13.0 || >=18.0.0 - Breaking
npmwill no longer attempt to modify ownership of files it creates - Breaking
The presence of auth related settings that are not scoped to a specific registry found in a config file is no longer supported and will throw errors
- Breaking
login,adduser, andauth-typechangeslegacy auth types
sso,saml&legacyhave been consolidated into"legacy"auth-typedefaults to"web"loginandadduserare now separate commands that send different data to
the registry.auth-typeconfig valueswebandlegacyonly try
their respective methods, npm no longer tries them all and waits to see
which one doesn't fail.
- Breaking
npm packnow follows a strict order of operations when applying ignore rules. If afilesarray is present in thepackage.json, then rules in.gitignoreand.npmignorefiles from the root will be ignored. - Breaking
Links generated from git urls will now use
HEADinstead ofmasteras the default ref - Breaking
timingandloglevelchangestiminghas been removed as a value for--loglevel--timingwill show timing information regardless of--loglevel, except when--silent
- Breaking
--timingfile changes:When run with the
--timingflag,npmnow writes timing data to a
file alongside the debug log data, respecting thelogs-diroption and
falling back to<CACHE>/_logs/dir, instead of directly inside the
cache directory.The timing file data is no longer newline delimited JSON, and instead
each run will create a uniquely named<ID>-timing.jsonfile, with the<ID>portion being the same as the debug log.Finally, the data inside the file now has three top level keys,
metadata,timers, andunfinishedTimersinstead of everything being
a top level key.
- Breaking
npmnow outputs some json errors on stdout. Previouslynpmwould output all json formatted errors on stderr, making it difficult to parse as the stderr stream usually has logs already written to it. In the future,npmwill differentiate between errors and crashes. Errors, such asE404andERESOLVE, will be handled and will continue to be output on stdout. In the case of a crash,npmwill log the error as usual but will not attempt to display it as json, even in--jsonmode. Moving a case from the category of an error to a crash will not be considered a breaking change. For more information see npm/rfcs#482. - Deprecated
Deprecate boolean install flags in favor of
--install-strategydeprecate
--global-style,--globalnow sets--install-strategy=shallowdeprecate
--legacy-bundling, now sets--install-strategy=nested
- Breaking
npm config setwill no longer accept deprecated or invalid config options - Breaking
install-linksconfig defaults to"true" - Breaking
node-versionconfig has been removed - Breaking
npm-versionconfig has been removed - Breaking
npm accesssubcommands have been renamed - Breaking
npm birthdayhas been removed - Breaking
npm set-scripthas been removed - Breaking
npm binhas been removed (usenpxornpm execto execute binaries)
Features
Introduce the
npm config fixcommandExplicitly validate config within the cli
rewrite: Docs generation
Use v3 lockfiles by default
Implement new
npm-packlistbehaviorWrite eresolve error files to the logs directory
Timings are now written alongside debug log files
Default
auth-typeto"web"query: Display
queryContextin resultsSeparate
login/adduser& remove unnecessary auth typesrewrite:
npm accessrewrite:
libnpmaccessworkspaces: Update supported node engines in
package.json- Deprecated
Add
--install-strategy=hoisted|nested|shallow, deprecate--global-style,--legacy-bundling Remove
npm birthdayRemove
npm set-scriptDefault
install-linksto"true"Remove
npm binUpdate supported node engines in package.json
Output json formatted errors on
stdoutRefuse to set deprecated/invalid config
Separate configs for
--timingand--loglevel- Deprecated
Deprecated
key,certconfig options and updated registry scoped auth docs
Bug Fixes
Add tag to publish log message
config: Remove
node-versionandnpm-versionlibnpmpack: Obey
foregroundScriptsnpm linkshould override--install-linksEnsure
Arboristconstructor gets passed around everywhere forpacoteaudit: Add a condition to allow third-party registries returning E400 (@juanheyns, Juan Heyns)
Attempt more graceful failure in older node versions
npm hook lsduplicates hook name prefixesAccount for new
npm-package-argbehaviorRemove
chownrandmkdirp-infer-owner
Dependencies
df77a1f #5707 Update Major Versions of Dependencies
Removed
- Breaking
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.