diff --git a/doc/api/process.md b/doc/api/process.md index 0dcfed70f946ac..d9867c5332d217 100644 --- a/doc/api/process.md +++ b/doc/api/process.md @@ -3827,6 +3827,29 @@ documentation for the [`'warning'` event][process_warning] and the [`emitWarning()` method][process_emit_warning] for more information about this flag's behavior. +## `process.traceProcessWarnings` + + + +* {boolean} + +The `process.traceProcessWarnings` property indicates whether the `--trace-warnings` flag +is set on the current Node.js process. This property allows programmatic control over the +tracing of warnings, enabling or disabling stack traces for warnings at runtime. + +```js +// Enable trace warnings +process.traceProcessWarnings = true; + +// Emit a warning with a stack trace +process.emitWarning('Warning with stack trace'); + +// Disable trace warnings +process.traceProcessWarnings = false; +``` + ## `process.umask()`