Gecko [ unitednationsplay.com ]

Name	Size	Permission	Date
assets	[ DIR ]	drwxr-xr-x	2022-01-26 16:43
addons.html	97.08 KB	-rw-r--r--	2022-01-10 13:06
addons.json	48.6 KB	-rw-r--r--	2022-01-10 13:06
addons.md	39.44 KB	-rw-r--r--	2022-01-10 13:06
all.html	5.06 MB	-rw-r--r--	2022-01-10 13:06
all.json	4.78 MB	-rw-r--r--	2022-01-10 13:06
assert.html	118.84 KB	-rw-r--r--	2022-01-10 13:06
assert.json	83.37 KB	-rw-r--r--	2022-01-10 13:06
assert.md	47.93 KB	-rw-r--r--	2022-01-10 13:06
async_hooks.html	94.53 KB	-rw-r--r--	2022-01-10 13:06
async_hooks.json	64.9 KB	-rw-r--r--	2022-01-10 13:06
async_hooks.md	38.62 KB	-rw-r--r--	2022-01-10 13:06
buffer.html	289.36 KB	-rw-r--r--	2022-01-10 13:06
buffer.json	227.52 KB	-rw-r--r--	2022-01-10 13:06
buffer.md	109.83 KB	-rw-r--r--	2022-01-10 13:06
child_process.html	156.96 KB	-rw-r--r--	2022-01-10 13:06
child_process.json	140.03 KB	-rw-r--r--	2022-01-10 13:06
child_process.md	69.69 KB	-rw-r--r--	2022-01-10 13:06
cli.html	99.52 KB	-rw-r--r--	2022-01-10 13:06
cli.json	97.49 KB	-rw-r--r--	2022-01-10 13:06
cli.md	47.37 KB	-rw-r--r--	2022-01-10 13:06
cluster.html	65.92 KB	-rw-r--r--	2022-01-10 13:06
cluster.json	45.84 KB	-rw-r--r--	2022-01-10 13:06
cluster.md	24.83 KB	-rw-r--r--	2022-01-10 13:06
console.html	50.57 KB	-rw-r--r--	2022-01-10 13:06
console.json	40.04 KB	-rw-r--r--	2022-01-10 13:06
console.md	16.55 KB	-rw-r--r--	2022-01-10 13:06
crypto.html	297.2 KB	-rw-r--r--	2022-01-10 13:06
crypto.json	261.36 KB	-rw-r--r--	2022-01-10 13:06
crypto.md	124.37 KB	-rw-r--r--	2022-01-10 13:06
debugger.html	21.62 KB	-rw-r--r--	2022-01-10 13:06
debugger.json	9.75 KB	-rw-r--r--	2022-01-10 13:06
debugger.md	6.43 KB	-rw-r--r--	2022-01-10 13:06
deprecations.html	142.64 KB	-rw-r--r--	2022-01-10 13:06
deprecations.json	164.68 KB	-rw-r--r--	2022-01-10 13:06
deprecations.md	81.32 KB	-rw-r--r--	2022-01-10 13:06
dgram.html	67.09 KB	-rw-r--r--	2022-01-10 13:06
dgram.json	57.33 KB	-rw-r--r--	2022-01-10 13:06
dgram.md	27.81 KB	-rw-r--r--	2022-01-10 13:06
diagnostics_channel.html	21.13 KB	-rw-r--r--	2022-01-10 13:06
diagnostics_channel.json	10.8 KB	-rw-r--r--	2022-01-10 13:06
diagnostics_channel.md	5.24 KB	-rw-r--r--	2022-01-10 13:06
dns.html	109.72 KB	-rw-r--r--	2022-01-10 13:06
dns.json	98.84 KB	-rw-r--r--	2022-01-10 13:06
dns.md	44.29 KB	-rw-r--r--	2022-01-10 13:06
documentation.html	18.4 KB	-rw-r--r--	2022-01-10 13:06
documentation.json	8.83 KB	-rw-r--r--	2022-01-10 13:06
documentation.md	4.05 KB	-rw-r--r--	2022-01-10 13:06
domain.html	41.38 KB	-rw-r--r--	2022-01-10 13:06
domain.json	22.06 KB	-rw-r--r--	2022-01-10 13:06
domain.md	15.2 KB	-rw-r--r--	2022-01-10 13:06
embedding.html	24.65 KB	-rw-r--r--	2022-01-10 13:06
embedding.json	10.05 KB	-rw-r--r--	2022-01-10 13:06
embedding.md	8.67 KB	-rw-r--r--	2022-01-10 13:06
errors.html	189.1 KB	-rw-r--r--	2022-01-10 13:06
errors.json	194.73 KB	-rw-r--r--	2022-01-10 13:06
errors.md	82.71 KB	-rw-r--r--	2022-01-10 13:06
esm.html	97.97 KB	-rw-r--r--	2022-01-10 13:06
esm.json	78.48 KB	-rw-r--r--	2022-01-10 13:06
esm.md	48.2 KB	-rw-r--r--	2022-01-10 13:06
events.html	129.56 KB	-rw-r--r--	2022-01-10 13:06
events.json	94.12 KB	-rw-r--r--	2022-01-10 13:06
events.md	43.71 KB	-rw-r--r--	2022-01-10 13:06
fs.html	503.09 KB	-rw-r--r--	2022-01-10 13:06
fs.json	500.22 KB	-rw-r--r--	2022-01-10 13:06
fs.md	210.32 KB	-rw-r--r--	2022-01-10 13:06
globals.html	29.55 KB	-rw-r--r--	2022-01-10 13:06
globals.json	31.16 KB	-rw-r--r--	2022-01-10 13:06
globals.md	8.21 KB	-rw-r--r--	2022-01-10 13:06
http.html	213.14 KB	-rw-r--r--	2022-01-10 13:06
http.json	214.96 KB	-rw-r--r--	2022-01-10 13:06
http.md	91.28 KB	-rw-r--r--	2022-01-10 13:06
http2.html	274.7 KB	-rw-r--r--	2022-01-10 13:06
http2.json	274.23 KB	-rw-r--r--	2022-01-10 13:06
http2.md	123.62 KB	-rw-r--r--	2022-01-10 13:06
https.html	44.54 KB	-rw-r--r--	2022-01-10 13:06
https.json	36.55 KB	-rw-r--r--	2022-01-10 13:06
https.md	14.58 KB	-rw-r--r--	2022-01-10 13:06
index.html	12.21 KB	-rw-r--r--	2022-01-10 13:06
index.json	54 B	-rw-r--r--	2022-01-10 13:06
index.md	1.73 KB	-rw-r--r--	2022-01-10 13:06
inspector.html	25.57 KB	-rw-r--r--	2022-01-10 13:06
inspector.json	13.43 KB	-rw-r--r--	2022-01-10 13:06
inspector.md	6.66 KB	-rw-r--r--	2022-01-10 13:06
intl.html	25.1 KB	-rw-r--r--	2022-01-10 13:06
intl.json	14.5 KB	-rw-r--r--	2022-01-10 13:06
intl.md	10.46 KB	-rw-r--r--	2022-01-10 13:06
module.html	23.9 KB	-rw-r--r--	2022-01-10 13:06
module.json	13.29 KB	-rw-r--r--	2022-01-10 13:06
module.md	5.2 KB	-rw-r--r--	2022-01-10 13:06
modules.html	67.19 KB	-rw-r--r--	2022-01-10 13:06
modules.json	48.92 KB	-rw-r--r--	2022-01-10 13:06
modules.md	30.83 KB	-rw-r--r--	2022-01-10 13:06
n-api.html	336.63 KB	-rw-r--r--	2022-01-10 13:06
n-api.json	330.37 KB	-rw-r--r--	2022-01-10 13:06
n-api.md	206.51 KB	-rw-r--r--	2022-01-10 13:06
net.html	111.64 KB	-rw-r--r--	2022-01-10 13:06
net.json	108.87 KB	-rw-r--r--	2022-01-10 13:06
net.md	44.19 KB	-rw-r--r--	2022-01-10 13:06
os.html	60.56 KB	-rw-r--r--	2022-01-10 13:06
os.json	50.72 KB	-rw-r--r--	2022-01-10 13:06
os.md	33.98 KB	-rw-r--r--	2022-01-10 13:06
packages.html	80.39 KB	-rw-r--r--	2022-01-10 13:06
packages.json	59.35 KB	-rw-r--r--	2022-01-10 13:06
packages.md	39.1 KB	-rw-r--r--	2022-01-10 13:06
path.html	43.66 KB	-rw-r--r--	2022-01-10 13:06
path.json	27.96 KB	-rw-r--r--	2022-01-10 13:06
path.md	14.46 KB	-rw-r--r--	2022-01-10 13:06
perf_hooks.html	71.71 KB	-rw-r--r--	2022-01-10 13:06
perf_hooks.json	49.24 KB	-rw-r--r--	2022-01-10 13:06
perf_hooks.md	23.17 KB	-rw-r--r--	2022-01-10 13:06
policy.html	35.98 KB	-rw-r--r--	2022-01-10 13:06
policy.json	18.38 KB	-rw-r--r--	2022-01-10 13:06
policy.md	13.9 KB	-rw-r--r--	2022-01-10 13:06
process.html	192.69 KB	-rw-r--r--	2022-01-10 13:06
process.json	150.9 KB	-rw-r--r--	2022-01-10 13:06
process.md	86.44 KB	-rw-r--r--	2022-01-10 13:06
punycode.html	19.88 KB	-rw-r--r--	2022-01-10 13:06
punycode.json	8.79 KB	-rw-r--r--	2022-01-10 13:06
punycode.md	4.17 KB	-rw-r--r--	2022-01-10 13:06
querystring.html	22.01 KB	-rw-r--r--	2022-01-10 13:06
querystring.json	12.74 KB	-rw-r--r--	2022-01-10 13:06
querystring.md	5.48 KB	-rw-r--r--	2022-01-10 13:06
readline.html	69.79 KB	-rw-r--r--	2022-01-10 13:06
readline.json	55.74 KB	-rw-r--r--	2022-01-10 13:06
readline.md	28.04 KB	-rw-r--r--	2022-01-10 13:06
repl.html	58.19 KB	-rw-r--r--	2022-01-10 13:06
repl.json	44.5 KB	-rw-r--r--	2022-01-10 13:06
repl.md	23.61 KB	-rw-r--r--	2022-01-10 13:06
report.html	71.4 KB	-rw-r--r--	2022-01-10 13:06
report.json	21.23 KB	-rw-r--r--	2022-01-10 13:06
report.md	17.92 KB	-rw-r--r--	2022-01-10 13:06
stream.html	226.43 KB	-rw-r--r--	2022-01-10 13:06
stream.json	223.31 KB	-rw-r--r--	2022-01-10 13:06
stream.md	100.94 KB	-rw-r--r--	2022-01-10 13:06
string_decoder.html	17.5 KB	-rw-r--r--	2022-01-10 13:06
string_decoder.json	5.8 KB	-rw-r--r--	2022-01-10 13:06
string_decoder.md	2.94 KB	-rw-r--r--	2022-01-10 13:06
synopsis.html	13.93 KB	-rw-r--r--	2022-01-10 13:06
synopsis.json	2.97 KB	-rw-r--r--	2022-01-10 13:06
synopsis.md	2.13 KB	-rw-r--r--	2022-01-10 13:06
timers.html	32.99 KB	-rw-r--r--	2022-01-10 13:06
timers.json	23.92 KB	-rw-r--r--	2022-01-10 13:06
timers.md	10.55 KB	-rw-r--r--	2022-01-10 13:06
tls.html	152.2 KB	-rw-r--r--	2022-01-10 13:06
tls.json	161.77 KB	-rw-r--r--	2022-01-10 13:06
tls.md	81.06 KB	-rw-r--r--	2022-01-10 13:06
tracing.html	22.43 KB	-rw-r--r--	2022-01-10 13:06
tracing.json	12.14 KB	-rw-r--r--	2022-01-10 13:06
tracing.md	6.59 KB	-rw-r--r--	2022-01-10 13:06
tty.html	29.16 KB	-rw-r--r--	2022-01-10 13:06
tty.json	22.31 KB	-rw-r--r--	2022-01-10 13:06
tty.md	8.78 KB	-rw-r--r--	2022-01-10 13:06
url.html	122.38 KB	-rw-r--r--	2022-01-10 13:06
url.json	88.21 KB	-rw-r--r--	2022-01-10 13:06
url.md	49.32 KB	-rw-r--r--	2022-01-10 13:06
util.html	199.52 KB	-rw-r--r--	2022-01-10 13:06
util.json	171.18 KB	-rw-r--r--	2022-01-10 13:06
util.md	71.47 KB	-rw-r--r--	2022-01-10 13:06
v8.html	51.61 KB	-rw-r--r--	2022-01-10 13:06
v8.json	39.5 KB	-rw-r--r--	2022-01-10 13:06
v8.md	16.55 KB	-rw-r--r--	2022-01-10 13:06
vm.html	123.51 KB	-rw-r--r--	2022-01-10 13:06
vm.json	113.19 KB	-rw-r--r--	2022-01-10 13:06
vm.md	55.37 KB	-rw-r--r--	2022-01-10 13:06
wasi.html	21.16 KB	-rw-r--r--	2022-01-10 13:06
wasi.json	11.72 KB	-rw-r--r--	2022-01-10 13:06
wasi.md	6.27 KB	-rw-r--r--	2022-01-10 13:06
worker_threads.html	90.29 KB	-rw-r--r--	2022-01-10 13:06
worker_threads.json	69.84 KB	-rw-r--r--	2022-01-10 13:06
worker_threads.md	39 KB	-rw-r--r--	2022-01-10 13:06
zlib.html	95.09 KB	-rw-r--r--	2022-01-10 13:06
zlib.json	100.2 KB	-rw-r--r--	2022-01-10 13:06
zlib.md	35.03 KB	-rw-r--r--	2022-01-10 13:06

Rename

# Trace events

> Stability: 1 - Experimental

The `trace_events` module provides a mechanism to centralize tracing information
generated by V8, Node.js core, and userspace code.

Tracing can be enabled with the `--trace-event-categories` command-line flag
or by using the `trace_events` module. The `--trace-event-categories` flag
accepts a list of comma-separated category names.

The available categories are:

* `node`: An empty placeholder.
* `node.async_hooks`: Enables capture of detailed [`async_hooks`][] trace data.
  The [`async_hooks`][] events have a unique `asyncId` and a special `triggerId`
  `triggerAsyncId` property.
* `node.bootstrap`: Enables capture of Node.js bootstrap milestones.
* `node.console`: Enables capture of `console.time()` and `console.count()`
  output.
* `node.dns.native`: Enables capture of trace data for DNS queries.
* `node.environment`: Enables capture of Node.js Environment milestones.
* `node.fs.sync`: Enables capture of trace data for file system sync methods.
* `node.perf`: Enables capture of [Performance API][] measurements.
  * `node.perf.usertiming`: Enables capture of only Performance API User Timing
    measures and marks.
  * `node.perf.timerify`: Enables capture of only Performance API timerify
    measurements.
* `node.promises.rejections`: Enables capture of trace data tracking the number
  of unhandled Promise rejections and handled-after-rejections.
* `node.vm.script`: Enables capture of trace data for the `vm` module's
  `runInNewContext()`, `runInContext()`, and `runInThisContext()` methods.
* `v8`: The [V8][] events are GC, compiling, and execution related.

By default the `node`, `node.async_hooks`, and `v8` categories are enabled.

```bash
node --trace-event-categories v8,node,node.async_hooks server.js
```

Prior versions of Node.js required the use of the `--trace-events-enabled`
flag to enable trace events. This requirement has been removed. However, the
`--trace-events-enabled` flag *may* still be used and will enable the
`node`, `node.async_hooks`, and `v8` trace event categories by default.

```bash
node --trace-events-enabled

# is equivalent to

node --trace-event-categories v8,node,node.async_hooks
```

Alternatively, trace events may be enabled using the `trace_events` module:

```js
const trace_events = require('trace_events');
const tracing = trace_events.createTracing({ categories: ['node.perf'] });
tracing.enable();  // Enable trace event capture for the 'node.perf' category

// do work

tracing.disable();  // Disable trace event capture for the 'node.perf' category
```

Running Node.js with tracing enabled will produce log files that can be opened
in the [`chrome://tracing`](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool)
tab of Chrome.

The logging file is by default called `node_trace.${rotation}.log`, where
`${rotation}` is an incrementing log-rotation id. The filepath pattern can
be specified with `--trace-event-file-pattern` that accepts a template
string that supports `${rotation}` and `${pid}`:

```bash
node --trace-event-categories v8 --trace-event-file-pattern '${pid}-${rotation}.log' server.js
```

The tracing system uses the same time source
as the one used by `process.hrtime()`.
However the trace-event timestamps are expressed in microseconds,
unlike `process.hrtime()` which returns nanoseconds.

The features from this module are not available in [`Worker`][] threads.

## The `trace_events` module

### `Tracing` object

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.

#### `tracing.categories`

* {string}

A comma-separated list of the trace event categories covered by this
`Tracing` object.

#### `tracing.disable()`

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.

```js
const trace_events = require('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());
```

#### `tracing.enable()`

Enables this `Tracing` object for the set of categories covered by the
`Tracing` object.

#### `tracing.enabled`

* {boolean} `true` only if the `Tracing` object has been enabled.

### `trace_events.createTracing(options)`

* `options` {Object}
  * `categories` {string[]} 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.
* Returns: {Tracing}.

Creates and returns a `Tracing` object for the given set of `categories`.

```js
const trace_events = require('trace_events');
const categories = ['node.perf', 'node.async_hooks'];
const tracing = trace_events.createTracing({ categories });
tracing.enable();
// do stuff
tracing.disable();
```

### `trace_events.getEnabledCategories()`

* Returns: {string}

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.

Given the file `test.js` below, the command
`node --trace-event-categories node.perf test.js` will print
`'node.async_hooks,node.perf'` to the console.

```js
const trace_events = require('trace_events');
const t1 = trace_events.createTracing({ categories: ['node.async_hooks'] });
const t2 = trace_events.createTracing({ categories: ['node.perf'] });
const t3 = trace_events.createTracing({ categories: ['v8'] });

t1.enable();
t2.enable();

console.log(trace_events.getEnabledCategories());
```

[Performance API]: perf_hooks.md
[V8]: v8.md
[`Worker`]: worker_threads.md#worker_threads_class_worker
[`async_hooks`]: async_hooks.md