doc: add documentation for process.traceProcessWarnings

AlirezaEbrahimkhani · aduh95 · commit 31476cd4d182 · 2026-01-19T19:19:36.000+01:00
resolves #53514 PR-URL: #53641 Reviewed-By: Aviv Keller <me@aviv.sh>
diff --git a/doc/api/process.md b/doc/api/process.md
@@ -4353,6 +4353,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`
+
+<!-- YAML
+added: v6.10.0
+-->
+
+* {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()`
 
 <!-- YAML
