Skip to content

feat!: error on unknown configs, flags, and abbreviations#9276

Open
owlstronaut wants to merge 1 commit intolatestfrom
feat/error-on-unknown-configs
Open

feat!: error on unknown configs, flags, and abbreviations#9276
owlstronaut wants to merge 1 commit intolatestfrom
feat/error-on-unknown-configs

Conversation

@owlstronaut
Copy link
Copy Markdown
Contributor

@owlstronaut owlstronaut commented Apr 23, 2026

BREAKING CHANGE: unknown configs in .npmrc, unknown CLI flags, abbreviated flags, and single-hyphen multi-char shorthands now throw instead of warning.

Closes npm/statusboard#1084.

Unknown configs are now hard errors instead of warnings:

  • Unknown keys in .npmrc (project/user/global/builtin), aggregated across files
  • Unknown CLI flags (--bogus)
  • Abbreviated flags (--dry for --dry-run)
  • Single-hyphen multi-char flags (-longflag)

Env (npm_config_*) and publishConfig unknowns still warn.

config, help, doctor, completion, and version opt out via static skipConfigValidation = true so npm config fix and friends keep working when .npmrc is broken.

Notable breaks

  • Legacy top-level auth keys (email, _authToken, _password, username, certfile, keyfile) must be in scoped/nerfdart form. Run npm config fix to migrate.
  • -j no longer expands to --json. Use --json.

@owlstronaut owlstronaut requested a review from a team as a code owner April 23, 2026 20:33
@owlstronaut owlstronaut force-pushed the feat/error-on-unknown-configs branch 4 times, most recently from 954d9b9 to a386ace Compare April 23, 2026 20:57
BREAKING CHANGE: unknown configs in .npmrc, unknown CLI flags, abbreviated flags, and single-hyphen multi-char shorthands now throw instead of warning.
@owlstronaut owlstronaut force-pushed the feat/error-on-unknown-configs branch from a386ace to fd9faf7 Compare April 23, 2026 21:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

error on unknown flags

1 participant