12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061 |
- declare module "trace_events" {
- /**
- * 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.
- */
- export interface Tracing {
- /**
- * A comma-separated list of the trace event categories covered by this
- * `Tracing` object.
- */
- readonly categories: string;
-
- /**
- * 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.
- */
- disable(): void;
-
- /**
- * Enables this `Tracing` object for the set of categories covered by
- * the `Tracing` object.
- */
- enable(): void;
-
- /**
- * `true` only if the `Tracing` object has been enabled.
- */
- readonly enabled: boolean;
- }
-
- interface CreateTracingOptions {
- /**
- * 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.
- */
- categories: string[];
- }
-
- /**
- * Creates and returns a Tracing object for the given set of categories.
- */
- export function createTracing(options: CreateTracingOptions): Tracing;
-
- /**
- * Returns a comma-separated list of all currently-enabled trace event
- * categories. The current set of enabled trace event categories is
- * determined by the union of all currently-enabled `Tracing` objects and
- * any categories enabled using the `--trace-event-categories` flag.
- */
- export function getEnabledCategories(): string;
- }
|