function
Creates and returns a Tracing object for the given set of categories.
import trace_events from 'node:trace_events';
const categories = ['node.perf', 'node.async_hooks'];
const tracing = trace_events.createTracing({ categories });
tracing.enable();
// do stuff
tracing.disable();
An array of trace category names. Values included in the array are coerced to a string when possible. An error will be thrown if the value cannot be coerced.
The Tracing object is used to enable or disable tracing for sets of categories. Instances are created using the trace_events.createTracing() method.
When created, the Tracing object is disabled. Calling the tracing.enable() method adds the categories to the set of enabled trace event categories. Calling tracing.disable() will remove the categories from the set of enabled trace event categories.
A comma-separated list of the trace event categories covered by this Tracing object.
Disables this Tracing object.
Only trace event categories not covered by other enabled Tracing objects and not specified by the --trace-event-categories flag will be disabled.
import trace_events from 'node:trace_events';
const t1 = trace_events.createTracing({ categories: ['node', 'v8'] });
const t2 = trace_events.createTracing({ categories: ['node.perf', 'node'] });
t1.enable();
t2.enable();
// Prints 'node,node.perf,v8'
console.log(trace_events.getEnabledCategories());
t2.disable(); // Will only disable emission of the 'node.perf' category
// Prints 'node,v8'
console.log(trace_events.getEnabledCategories());
Enables this Tracing object for the set of categories covered by the Tracing object.