You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
It appears in neither doc/api/cli.md nor doc/node.1. When the flag was added,
it was instead placed in the "intentionally undocumented options" list in test/parallel/test-process-env-allowed-flags-are-documented.js, which is what
keeps that test passing today:
Every sibling tracing flag is documented: --trace-env, --trace-uncaught, --trace-warnings, --trace-exit, --trace-sync-io. The other entries in that
exemption list are either legacy no-ops (--experimental-fetch, --napi-modules) or internal-only debugging switches
(--verify-base-objects, --debug-arraybuffer-allocations). --trace-promises is neither, so this looks like an oversight rather than a
deliberate omission.
I would like to send a PR documenting it and removing the exemption.
Affected URL(s)
https://nodejs.org/api/cli.html
Description of the problem
--trace-promisesis implemented and shipped, but it is not documented anywherein the CLI reference.
src/node_options.ccwithkAllowedInEnvvar, so it can also beset through
NODE_OPTIONS.src/env.ccasEnvironment::TracePromises, installed as anisolate-wide promise hook in
src/node.cc.It appears in neither
doc/api/cli.mdnordoc/node.1. When the flag was added,it was instead placed in the "intentionally undocumented options" list in
test/parallel/test-process-env-allowed-flags-are-documented.js, which is whatkeeps that test passing today:
Every sibling tracing flag is documented:
--trace-env,--trace-uncaught,--trace-warnings,--trace-exit,--trace-sync-io. The other entries in thatexemption list are either legacy no-ops (
--experimental-fetch,--napi-modules) or internal-only debugging switches(
--verify-base-objects,--debug-arraybuffer-allocations).--trace-promisesis neither, so this looks like an oversight rather than adeliberate omission.
I would like to send a PR documenting it and removing the exemption.