diff --git a/doc/api/cli.md b/doc/api/cli.md index 9c5af91ae13f91..bf12672d6dafca 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -911,6 +911,36 @@ added: v23.6.0 Enable experimental import support for `.node` addons. +### `--experimental-config-file` + + + +> Stability: 1.0 - Early development + +Use this flag to specify a configuration file that will be loaded and parsed +before the application starts. +Node.js will read the configuration file and apply the settings as +[`NODE_OPTIONS`][]. +The configuration file should be a JSON file +with the following structure: + +```json +{ + "version": 0, + "experimental_transform_types": true +} +``` + +Currently the only supported version is 0. +The configuration file cannot be used in conjuction with `--env-file`. +The configuration file cannot be used if [`NODE_OPTIONS`][] are set. +The configuration file will not override the flag passed in the command line. +If multiple keys are present in the configuration file, only the first one +will be considered and the followin will be ignored. +Unknown keys will be ignored. + ### `--experimental-eventsource`