Note to maintainers: this is the same behavior in npm 10.8.2

EDIT: I do agree with the author of the issue

I am writing to express my interest in addressing the issue involving environment variable substitution in .npmrc—specifically, how ${NODE_OPTIONS} behaves when the variable is undefined. This behavior currently causes Node.js to fail or ignore critical flags due to incorrect string substitution, which leads to unreliable configurations for developers. The Problem When node-options = "${NODE_OPTIONS} --max-old-space-size=1" is used in .npmrc, it works as expected only if NODE_OPTIONS is already set. However, if it's not defined at all, the placeholder is passed literally as ${NODE_OPTIONS}, causing Node.js to reject or ignore all flags. This behavior breaks consistency and creates potential runtime issues.

The entire replacement boils down to https://github.com/npm/cli/blob/latest/workspaces/config/lib/env-replace.js file which has a simple code for replacing env vars after ini package parses the config.

I reckoned that existing projects might rely on the variables not being replaced if the value is not defined so silently changing the code to evaluate to empty string if the env var is undefined might not be a good idea.

Then I considered what would it take to implement ${FOO:default} syntax and quickly relized that it falls into a parsing and escaping hell (what if someone wants to default to string that contains } or \\ or \\} etc). Having defaults would be nice but solving the original problem doesn't need it.

So after all, since the syntax is custom anyway, I though that simple and reliable solution would be to introduce a ? modifier. It could be put after the var name, like this: ${FOO?} and signals that the var is optional and can be evaluated to empty string.

Summary of the idea:

• when FOO is undefined
  • ${FOO} evals to ${FOO} (unchanged behavior)
  • ${FOO?} evals to empty string (new behavior)
• when FOO is set to bar
  • ${FOO} evals to bar (unchanged behavior)
  • ${FOO?} evals to bar (unchanged behavior)

Existuje pro to nějaký existující problém?

• Prohledal jsem existující problémy
  To pick up a draggable item, press the space bar. While dragging, use the arrow keys to move the item. Press space again to drop the item in its new position, or press escape to cancel.

Tento problém existuje v nejnovější verzi npm.

• Používám nejnovější npm
  To pick up a draggable item, press the space bar. While dragging, use the arrow keys to move the item. Press space again to drop the item in its new position, or press escape to cancel.

Aktuální chování

Pokud přidám následující řádek do .npmrc:

node-options = "${NODE_OPTIONS} --use-system-ca"

Funguje to správně, pokud byl NODE_OPTIONS předtím nastaven na některé příznaky uzlů v mém prostředí. Například, pokud to udělám

export NODE_OPTIONS=--inspect
npm run foo

Pak uzel spuštěný skriptem "foo" přijímá --inspect --use-system-cajako volby uzlu a je to v pořádku.

Pokud ale NODE_OPTIONSproměnná prostředí (env var) není v danou chvíli nastavena na žádnou hodnotu npm run foo, uzel je přijme ${NODE_OPTIONS} --use-system-cajako možnosti a uzel je všechny možnosti odmítne ( --use-system-cataké je ignorován).

V důsledku toho, že npm ponechává substituce proměnných nedotčené, pokud proměnná není nastavena, neexistuje způsob, jak spolehlivě rozšířit možnosti uzlu pomocí .npmrc namísto jejich nahrazení.

Očekávané chování

Buď:

• ${FOO}Vzor substituce var by měl být eval na prázdný řetězec, pokud není definován FOO.
• Nebo by měla být možná možnost zadat výchozí hodnoty způsobem podobným bash. ${FOO:-''}Lze tedy použít pouze prázdný řetězec, pokud proměnná není vůbec definována.

Kroky k reprodukci

1. Přidejte tento skript do souboru package.json:"foo": "node -e 'console.log(process.env.NODE_OPTIONS);'"
2. Přidejte tento řádek do souboru .npmrc:node-options = "${NODE_OPTIONS} --max-old-space-size=1"
3. spustit NODE_OPTIONS='' npm run foo- jak se očekávalo, uzel se nespustí, protože mu dojde přidělený 1 MB paměti, což znamená, že příznaky byly předány v pořádku
4. unset NODE_OPTIONSaby se ujistil, že není nastaven na žádnou hodnotu, ani na prázdný řetězec
5. npm run foo
6. Vidíte ${NODE_OPTIONS} --max-old-space-size=1vytištěné a Node dokončí v pořádku, což znamená, že NODE_OPTIONS byly ignorovány kvůli nesprávnému řetězci vyplývajícímu z nesubstituované proměnné.

Prostředí

• npm: 11.4.1
• Node.js: 22.15.1
• Název operačního systému: Windows
• Název modelu systému:
• konfigurace npm:

; "user" config from C:\Users(...).npmrc

email = (protected)
script-shell = "C:\Program Files\Git\usr\bin\bash.exe"

; "project" config from C:(...).npmrc

fetch-retries = 4
legacy-peer-deps = true
node-options = "${NODE_OPTIONS} --max-old-space-size=1"
save-exact = true
save-prefix = ""

; node bin location = C:\Users(...)\AppData\Local\fnm_multishells\32040_1748498818910\node.exe
; node version = v22.15.1
; npm local prefix = C:(...)
; npm version = 10.9.2
; cwd = C:(...)
; HOME = C:\Users(...)