Skip to content

doc: mark --env-file and --env-file-if-exists as stable #59925

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Oct 3, 2025
+16 −9
Merged

doc: mark --env-file and --env-file-if-exists as stable #59925

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
265f3b2
doc: mark --env-file and --env-file-if-exists as stable
Hilzu Sep 18, 2025
0b555dc
doc: use correct terminology for newly stable feature
Hilzu Sep 23, 2025
4d4417c
doc: mark `process.loadEnvFile` and `util.parseEnv` as stable
Hilzu Sep 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 7 additions & 4 deletions doc/api/cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -881,10 +881,12 @@ node --entry-url 'data:text/javascript,console.log("Hello")'

<!-- YAML
added: v22.9.0
changes:
- version: REPLACEME
pr-url: https://github.com/nodejs/node/pull/59925
description: The `--env-file-if-exists` flag is no longer experimental.
-->

> Stability: 1.1 - Active development

Behavior is the same as [`--env-file`][], but an error is not thrown if the file
does not exist.

Expand All @@ -893,15 +895,16 @@ does not exist.
<!-- YAML
added: v20.6.0
changes:
- version: REPLACEME
pr-url: https://github.com/nodejs/node/pull/59925
description: The `--env-file` flag is no longer experimental.
- version:
- v21.7.0
- v20.12.0
pr-url: https://github.com/nodejs/node/pull/51289
description: Add support to multi-line values.
-->

> Stability: 1.1 - Active development

Loads environment variables from a file relative to the current directory,
making them available to applications on `process.env`. The [environment
variables which configure Node.js][environment_variables], such as `NODE_OPTIONS`,
Expand Down
2 changes: 1 addition & 1 deletion doc/api/environment_variables.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ For more details refer to the [`process.env` documentation][].

Set of utilities for dealing with additional environment variables defined in `.env` files.

> Stability: 1.1 - Active development
> Stability: 2 - Stable

<!--introduced_in=v20.12.0-->

Expand Down
6 changes: 4 additions & 2 deletions doc/api/process.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2696,10 +2696,12 @@ debugger. See [Signal Events][].
added:
- v21.7.0
- v20.12.0
changes:
- version: REPLACEME
pr-url: https://github.com/nodejs/node/pull/59925
description: This API is no longer experimental.
-->

> Stability: 1.1 - Active development

* `path` {string | URL | Buffer | undefined}. **Default:** `'./.env'`

Loads the `.env` file into `process.env`. Usage of `NODE_OPTIONS`
Expand Down
6 changes: 4 additions & 2 deletions doc/api/util.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2211,10 +2211,12 @@ $ node negate.js --no-logfile --logfile=test.log --color --no-color
added:
- v21.7.0
- v20.12.0
changes:
- version: REPLACEME
pr-url: https://github.com/nodejs/node/pull/59925
description: This API is no longer experimental.
-->

> Stability: 1.1 - Active development

* `content` {string}

The raw contents of a `.env` file.
Expand Down
Loading