From 265f3b2fa9af9e2d093c45bb3309e3555af9fb29 Mon Sep 17 00:00:00 2001 From: Santeri Hiltunen Date: Thu, 18 Sep 2025 16:43:39 +0300 Subject: [PATCH 1/3] doc: mark --env-file and --env-file-if-exists as stable As discussed in the referenced issue the feature should be ready to be marked as stable. Refs: https://github.com/nodejs/node/issues/49148#issuecomment-3307309232 --- doc/api/cli.md | 11 +++++++---- doc/api/environment_variables.md | 2 +- 2 files changed, 8 insertions(+), 5 deletions(-) diff --git a/doc/api/cli.md b/doc/api/cli.md index 9f9c8faa7d1a1c..c2e555392136a7 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -881,10 +881,12 @@ node --entry-url 'data:text/javascript,console.log("Hello")' -> Stability: 1.1 - Active development - Behavior is the same as [`--env-file`][], but an error is not thrown if the file does not exist. @@ -893,6 +895,9 @@ does not exist. -> 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`, diff --git a/doc/api/environment_variables.md b/doc/api/environment_variables.md index 747d8313c4b7fa..de1fc0a396c0e4 100644 --- a/doc/api/environment_variables.md +++ b/doc/api/environment_variables.md @@ -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 From 0b555dcce84cece29c6ef66b182eccbc43f85b0f Mon Sep 17 00:00:00 2001 From: Santeri Hiltunen Date: Tue, 23 Sep 2025 11:23:13 +0300 Subject: [PATCH 2/3] doc: use correct terminology for newly stable feature --- doc/api/cli.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/api/cli.md b/doc/api/cli.md index c2e555392136a7..a4320e75ab4f31 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -884,7 +884,7 @@ added: v22.9.0 changes: - version: REPLACEME pr-url: https://github.com/nodejs/node/pull/59925 - description: The `--env-file-if-exists` flag is now stable. + description: The `--env-file-if-exists` flag is no longer experimental. --> Behavior is the same as [`--env-file`][], but an error is not thrown if the file @@ -897,7 +897,7 @@ added: v20.6.0 changes: - version: REPLACEME pr-url: https://github.com/nodejs/node/pull/59925 - description: The `--env-file` flag is now stable. + description: The `--env-file` flag is no longer experimental. - version: - v21.7.0 - v20.12.0 From 4d4417c69b8227a00f23b10de38c95ea128b782e Mon Sep 17 00:00:00 2001 From: Santeri Hiltunen Date: Wed, 24 Sep 2025 12:02:40 +0300 Subject: [PATCH 3/3] doc: mark `process.loadEnvFile` and `util.parseEnv` as stable --- doc/api/process.md | 6 ++++-- doc/api/util.md | 6 ++++-- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/doc/api/process.md b/doc/api/process.md index e30639f6a006f3..85a37237c55362 100644 --- a/doc/api/process.md +++ b/doc/api/process.md @@ -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` diff --git a/doc/api/util.md b/doc/api/util.md index 01c12a6cfb2020..2fed523db4f8d4 100644 --- a/doc/api/util.md +++ b/doc/api/util.md @@ -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.