Gecko [ tsuru-no-tsurugi.tokyo ]

Name	Size	Permission	Date
assets	[ DIR ]	drwxr-xr-x	2025-12-31 20:37
addons.html	106.56 KB	-rw-r--r--	2025-03-27 09:56
addons.json.gz	10.95 KB	-rw-r--r--	2025-03-27 09:56
addons.md	39.76 KB	-rw-r--r--	2025-03-27 09:56
all.html	7.41 MB	-rw-r--r--	2025-03-27 09:56
all.json.gz	902.17 KB	-rw-r--r--	2025-03-27 09:56
assert.html	192.05 KB	-rw-r--r--	2025-03-27 09:56
assert.json.gz	13 KB	-rw-r--r--	2025-03-27 09:56
assert.md	66.51 KB	-rw-r--r--	2025-03-27 09:56
async_context.html	84.88 KB	-rw-r--r--	2025-03-27 09:56
async_context.json.gz	7.1 KB	-rw-r--r--	2025-03-27 09:56
async_context.md	24.68 KB	-rw-r--r--	2025-03-27 09:56
async_hooks.html	88.11 KB	-rw-r--r--	2025-03-27 09:56
async_hooks.json.gz	9.82 KB	-rw-r--r--	2025-03-27 09:56
async_hooks.md	30.51 KB	-rw-r--r--	2025-03-27 09:56
buffer.html	479.74 KB	-rw-r--r--	2025-03-27 09:56
buffer.json.gz	28.89 KB	-rw-r--r--	2025-03-27 09:56
buffer.md	148.96 KB	-rw-r--r--	2025-03-27 09:56
child_process.html	170.26 KB	-rw-r--r--	2025-03-27 09:56
child_process.json.gz	20.98 KB	-rw-r--r--	2025-03-27 09:56
child_process.md	70.69 KB	-rw-r--r--	2025-03-27 09:56
cli.html	161.74 KB	-rw-r--r--	2025-03-27 09:56
cli.json.gz	25.06 KB	-rw-r--r--	2025-03-27 09:56
cli.md	67.4 KB	-rw-r--r--	2025-03-27 09:56
cluster.html	91.42 KB	-rw-r--r--	2025-03-27 09:56
cluster.json.gz	9.48 KB	-rw-r--r--	2025-03-27 09:56
cluster.md	28.84 KB	-rw-r--r--	2025-03-27 09:56
console.html	60.27 KB	-rw-r--r--	2025-03-27 09:56
console.json.gz	6.07 KB	-rw-r--r--	2025-03-27 09:56
console.md	16.5 KB	-rw-r--r--	2025-03-27 09:56
corepack.html	23.41 KB	-rw-r--r--	2025-03-27 09:56
corepack.json.gz	2.55 KB	-rw-r--r--	2025-03-27 09:56
corepack.md	5.08 KB	-rw-r--r--	2025-03-27 09:56
crypto.html	523.1 KB	-rw-r--r--	2025-03-27 09:56
crypto.json.gz	45.94 KB	-rw-r--r--	2025-03-27 09:56
crypto.md	194.44 KB	-rw-r--r--	2025-03-27 09:56
debugger.html	28.99 KB	-rw-r--r--	2025-03-27 09:56
debugger.json.gz	3.12 KB	-rw-r--r--	2025-03-27 09:56
debugger.md	7.02 KB	-rw-r--r--	2025-03-27 09:56
deprecations.html	199.72 KB	-rw-r--r--	2025-03-27 09:56
deprecations.json.gz	23.9 KB	-rw-r--r--	2025-03-27 09:56
deprecations.md	98.32 KB	-rw-r--r--	2025-03-27 09:56
dgram.html	91.02 KB	-rw-r--r--	2025-03-27 09:56
dgram.json.gz	10.19 KB	-rw-r--r--	2025-03-27 09:56
dgram.md	30.99 KB	-rw-r--r--	2025-03-27 09:56
diagnostics_channel.html	97.27 KB	-rw-r--r--	2025-03-27 09:56
diagnostics_channel.json.gz	7.45 KB	-rw-r--r--	2025-03-27 09:56
diagnostics_channel.md	31.06 KB	-rw-r--r--	2025-03-27 09:56
dns.html	131.53 KB	-rw-r--r--	2025-03-27 09:56
dns.json.gz	15.74 KB	-rw-r--r--	2025-03-27 09:56
dns.md	52.17 KB	-rw-r--r--	2025-03-27 09:56
documentation.html	26.08 KB	-rw-r--r--	2025-03-27 09:56
documentation.json.gz	2.26 KB	-rw-r--r--	2025-03-27 09:56
documentation.md	4.74 KB	-rw-r--r--	2025-03-27 09:56
domain.html	49.31 KB	-rw-r--r--	2025-03-27 09:56
domain.json.gz	6.2 KB	-rw-r--r--	2025-03-27 09:56
domain.md	15.21 KB	-rw-r--r--	2025-03-27 09:56
embedding.html	26.64 KB	-rw-r--r--	2025-03-27 09:56
embedding.json.gz	3.01 KB	-rw-r--r--	2025-03-27 09:56
embedding.md	6.65 KB	-rw-r--r--	2025-03-27 09:56
errors.html	284.97 KB	-rw-r--r--	2025-03-27 09:56
errors.json.gz	42.36 KB	-rw-r--r--	2025-03-27 09:56
errors.md	97.03 KB	-rw-r--r--	2025-03-27 09:56
esm.html	89.14 KB	-rw-r--r--	2025-03-27 09:56
esm.json.gz	14.96 KB	-rw-r--r--	2025-03-27 09:56
esm.md	41.13 KB	-rw-r--r--	2025-03-27 09:56
events.html	230.85 KB	-rw-r--r--	2025-03-27 09:56
events.json.gz	17.25 KB	-rw-r--r--	2025-03-27 09:56
events.md	66.55 KB	-rw-r--r--	2025-03-27 09:56
fs.html	633.14 KB	-rw-r--r--	2025-03-27 09:56
fs.json.gz	67.08 KB	-rw-r--r--	2025-03-27 09:56
fs.md	248.67 KB	-rw-r--r--	2025-03-27 09:56
globals.html	75.67 KB	-rw-r--r--	2025-03-27 09:56
globals.json.gz	9 KB	-rw-r--r--	2025-03-27 09:56
globals.md	20.01 KB	-rw-r--r--	2025-03-27 09:56
http.html	301.5 KB	-rw-r--r--	2025-03-27 09:56
http.json.gz	35.76 KB	-rw-r--r--	2025-03-27 09:56
http.md	113.28 KB	-rw-r--r--	2025-03-27 09:56
http2.html	318.89 KB	-rw-r--r--	2025-03-27 09:56
http2.json.gz	39.24 KB	-rw-r--r--	2025-03-27 09:56
http2.md	129.92 KB	-rw-r--r--	2025-03-27 09:56
https.html	57.3 KB	-rw-r--r--	2025-03-27 09:56
https.json.gz	5.69 KB	-rw-r--r--	2025-03-27 09:56
https.md	16.33 KB	-rw-r--r--	2025-03-27 09:56
index.html	13.44 KB	-rw-r--r--	2025-03-27 09:56
index.json	54 B	-rw-r--r--	2025-03-27 09:56
index.md	1.97 KB	-rw-r--r--	2025-03-27 09:56
inspector.html	35.1 KB	-rw-r--r--	2025-03-27 09:56
inspector.json.gz	3.62 KB	-rw-r--r--	2025-03-27 09:56
inspector.md	7.63 KB	-rw-r--r--	2025-03-27 09:56
intl.html	32.73 KB	-rw-r--r--	2025-03-27 09:56
intl.json.gz	3.87 KB	-rw-r--r--	2025-03-27 09:56
intl.md	10.71 KB	-rw-r--r--	2025-03-27 09:56
module.html	99.46 KB	-rw-r--r--	2025-03-27 09:56
module.json.gz	12.9 KB	-rw-r--r--	2025-03-27 09:56
module.md	35.82 KB	-rw-r--r--	2025-03-27 09:56
modules.html	81.42 KB	-rw-r--r--	2025-03-27 09:56
modules.json.gz	12.66 KB	-rw-r--r--	2025-03-27 09:56
modules.md	32.97 KB	-rw-r--r--	2025-03-27 09:56
n-api.html	410.98 KB	-rw-r--r--	2025-03-27 09:56
n-api.json.gz	52.81 KB	-rw-r--r--	2025-03-27 09:56
n-api.md	223.67 KB	-rw-r--r--	2025-03-27 09:56
net.html	148.47 KB	-rw-r--r--	2025-03-27 09:56
net.json.gz	18.33 KB	-rw-r--r--	2025-03-27 09:56
net.md	53.5 KB	-rw-r--r--	2025-03-27 09:56
os.html	72.68 KB	-rw-r--r--	2025-03-27 09:56
os.json.gz	8.88 KB	-rw-r--r--	2025-03-27 09:56
os.md	35.5 KB	-rw-r--r--	2025-03-27 09:56
packages.html	101.35 KB	-rw-r--r--	2025-03-27 09:56
packages.json.gz	15.41 KB	-rw-r--r--	2025-03-27 09:56
packages.md	46.43 KB	-rw-r--r--	2025-03-27 09:56
path.html	53.27 KB	-rw-r--r--	2025-03-27 09:56
path.json.gz	4.9 KB	-rw-r--r--	2025-03-27 09:56
path.md	14.91 KB	-rw-r--r--	2025-03-27 09:56
perf_hooks.html	140.73 KB	-rw-r--r--	2025-03-27 09:56
perf_hooks.json.gz	12.51 KB	-rw-r--r--	2025-03-27 09:56
perf_hooks.md	42.15 KB	-rw-r--r--	2025-03-27 09:56
permissions.html	45.46 KB	-rw-r--r--	2025-03-27 09:56
permissions.json.gz	5.44 KB	-rw-r--r--	2025-03-27 09:56
permissions.md	14.59 KB	-rw-r--r--	2025-03-27 09:56
policy.html	15.05 KB	-rw-r--r--	2025-03-27 09:56
policy.json	476 B	-rw-r--r--	2025-03-27 09:56
policy.md	222 B	-rw-r--r--	2025-03-27 09:56
process.html	291.96 KB	-rw-r--r--	2025-03-27 09:56
process.json.gz	31.35 KB	-rw-r--r--	2025-03-27 09:56
process.md	107.1 KB	-rw-r--r--	2025-03-27 09:56
punycode.html	27.08 KB	-rw-r--r--	2025-03-27 09:56
punycode.json.gz	2 KB	-rw-r--r--	2025-03-27 09:56
punycode.md	4.17 KB	-rw-r--r--	2025-03-27 09:56
querystring.html	29.1 KB	-rw-r--r--	2025-03-27 09:56
querystring.json.gz	2.65 KB	-rw-r--r--	2025-03-27 09:56
querystring.md	5.57 KB	-rw-r--r--	2025-03-27 09:56
readline.html	110.11 KB	-rw-r--r--	2025-03-27 09:56
readline.json.gz	11.91 KB	-rw-r--r--	2025-03-27 09:56
readline.md	40.48 KB	-rw-r--r--	2025-03-27 09:56
repl.html	69.56 KB	-rw-r--r--	2025-03-27 09:56
repl.json.gz	10 KB	-rw-r--r--	2025-03-27 09:56
repl.md	23.69 KB	-rw-r--r--	2025-03-27 09:56
report.html	82.38 KB	-rw-r--r--	2025-03-27 09:56
report.json.gz	6.39 KB	-rw-r--r--	2025-03-27 09:56
report.md	18.83 KB	-rw-r--r--	2025-03-27 09:56
single-executable-applications.html	26.11 KB	-rw-r--r--	2025-03-27 09:56
single-executable-applications.json.gz	2.7 KB	-rw-r--r--	2025-03-27 09:56
single-executable-applications.md	6.1 KB	-rw-r--r--	2025-03-27 09:56
stream.html	399.91 KB	-rw-r--r--	2025-03-27 09:56
stream.json.gz	51.38 KB	-rw-r--r--	2025-03-27 09:56
stream.md	146.64 KB	-rw-r--r--	2025-03-27 09:56
string_decoder.html	24.3 KB	-rw-r--r--	2025-03-27 09:56
string_decoder.json.gz	1.55 KB	-rw-r--r--	2025-03-27 09:56
string_decoder.md	2.9 KB	-rw-r--r--	2025-03-27 09:56
synopsis.html	20.38 KB	-rw-r--r--	2025-03-27 09:56
synopsis.json	2.96 KB	-rw-r--r--	2025-03-27 09:56
synopsis.md	2.12 KB	-rw-r--r--	2025-03-27 09:56
test.html	227.62 KB	-rw-r--r--	2025-03-27 09:56
test.json.gz	20.4 KB	-rw-r--r--	2025-03-27 09:56
test.md	77.32 KB	-rw-r--r--	2025-03-27 09:56
timers.html	58.12 KB	-rw-r--r--	2025-03-27 09:56
timers.json.gz	5.28 KB	-rw-r--r--	2025-03-27 09:56
timers.md	15.81 KB	-rw-r--r--	2025-03-27 09:56
tls.html	181.66 KB	-rw-r--r--	2025-03-27 09:56
tls.json.gz	32.58 KB	-rw-r--r--	2025-03-27 09:56
tls.md	88.87 KB	-rw-r--r--	2025-03-27 09:56
tracing.html	35.22 KB	-rw-r--r--	2025-03-27 09:56
tracing.json.gz	3.47 KB	-rw-r--r--	2025-03-27 09:56
tracing.md	8.52 KB	-rw-r--r--	2025-03-27 09:56
tty.html	37.77 KB	-rw-r--r--	2025-03-27 09:56
tty.json.gz	3.72 KB	-rw-r--r--	2025-03-27 09:56
tty.md	8.91 KB	-rw-r--r--	2025-03-27 09:56
url.html	152.76 KB	-rw-r--r--	2025-03-27 09:56
url.json.gz	15.93 KB	-rw-r--r--	2025-03-27 09:56
url.md	54.46 KB	-rw-r--r--	2025-03-27 09:56
util.html	286.48 KB	-rw-r--r--	2025-03-27 09:56
util.json.gz	26.23 KB	-rw-r--r--	2025-03-27 09:56
util.md	96.24 KB	-rw-r--r--	2025-03-27 09:56
v8.html	112.17 KB	-rw-r--r--	2025-03-27 09:56
v8.json.gz	11.86 KB	-rw-r--r--	2025-03-27 09:56
v8.md	34.31 KB	-rw-r--r--	2025-03-27 09:56
vm.html	145.37 KB	-rw-r--r--	2025-03-27 09:56
vm.json.gz	16.9 KB	-rw-r--r--	2025-03-27 09:56
vm.md	61.11 KB	-rw-r--r--	2025-03-27 09:56
wasi.html	28.74 KB	-rw-r--r--	2025-03-27 09:56
wasi.json.gz	2.86 KB	-rw-r--r--	2025-03-27 09:56
wasi.md	6.54 KB	-rw-r--r--	2025-03-27 09:56
webcrypto.html	153.34 KB	-rw-r--r--	2025-03-27 09:56
webcrypto.json.gz	9.86 KB	-rw-r--r--	2025-03-27 09:56
webcrypto.md	45.75 KB	-rw-r--r--	2025-03-27 09:56
webstreams.html	151.84 KB	-rw-r--r--	2025-03-27 09:56
webstreams.json.gz	9.95 KB	-rw-r--r--	2025-03-27 09:56
webstreams.md	37.04 KB	-rw-r--r--	2025-03-27 09:56
worker_threads.html	114.31 KB	-rw-r--r--	2025-03-27 09:56
worker_threads.json.gz	14.46 KB	-rw-r--r--	2025-03-27 09:56
worker_threads.md	43.24 KB	-rw-r--r--	2025-03-27 09:56
zlib.html	109.68 KB	-rw-r--r--	2025-03-27 09:56
zlib.json.gz	10.34 KB	-rw-r--r--	2025-03-27 09:56
zlib.md	35.1 KB	-rw-r--r--	2025-03-27 09:56

Rename

# Inspector

> Stability: 2 - Stable

The `node:inspector` module provides an API for interacting with the V8
inspector.

It can be accessed using:

```js
const inspector = require('node:inspector');
```

## `inspector.close()`

Deactivate the inspector. Blocks until there are no active connections.

When using `Session`, the object outputted by the console API will not be
released, unless we performed manually `Runtime.DiscardConsoleEntries`
command.

## `inspector.console`

* {Object} An object to send messages to the remote inspector console.

```js
require('node:inspector').console.log('a message');
```

The inspector console does not have API parity with Node.js
console.

## `inspector.open([port[, host[, wait]]])`

* `port` {number} Port to listen on for inspector connections. Optional.
  **Default:** what was specified on the CLI.
* `host` {string} Host to listen on for inspector connections. Optional.
  **Default:** what was specified on the CLI.
* `wait` {boolean} Block until a client has connected. Optional.
  **Default:** `false`.

Activate inspector on host and port. Equivalent to
`node --inspect=[[host:]port]`, but can be done programmatically after node has
started.

If wait is `true`, will block until a client has connected to the inspect port
and flow control has been passed to the debugger client.

See the [security warning][] regarding the `host`
parameter usage.

## `inspector.url()`

* Returns: {string|undefined}

Return the URL of the active inspector, or `undefined` if there is none.

```console
$ node --inspect -p 'inspector.url()'
Debugger listening on ws://127.0.0.1:9229/166e272e-7a30-4d09-97ce-f1c012b43c34
For help, see: https://nodejs.org/en/docs/inspector
ws://127.0.0.1:9229/166e272e-7a30-4d09-97ce-f1c012b43c34

$ node --inspect=localhost:3000 -p 'inspector.url()'
Debugger listening on ws://localhost:3000/51cf8d0e-3c36-4c59-8efd-54519839e56a
For help, see: https://nodejs.org/en/docs/inspector
ws://localhost:3000/51cf8d0e-3c36-4c59-8efd-54519839e56a

$ node -p 'inspector.url()'
undefined
```

## `inspector.waitForDebugger()`

Blocks until a client (existing or connected later) has sent
`Runtime.runIfWaitingForDebugger` command.

An exception will be thrown if there is no active inspector.

## Class: `inspector.Session`

* Extends: {EventEmitter}

The `inspector.Session` is used for dispatching messages to the V8 inspector
back-end and receiving message responses and notifications.

### `new inspector.Session()`

Create a new instance of the `inspector.Session` class. The inspector session
needs to be connected through [`session.connect()`][] before the messages
can be dispatched to the inspector backend.

When using `Session`, the object outputted by the console API will not be
released, unless we performed manually `Runtime.DiscardConsoleEntries`
command.

### Event: `'inspectorNotification'`

* {Object} The notification message object

Emitted when any notification from the V8 Inspector is received.

```js
session.on('inspectorNotification', (message) => console.log(message.method));
// Debugger.paused
// Debugger.resumed
```

It is also possible to subscribe only to notifications with specific method:

### Event: `<inspector-protocol-method>`;

* {Object} The notification message object

Emitted when an inspector notification is received that has its method field set
to the `<inspector-protocol-method>` value.

The following snippet installs a listener on the [`'Debugger.paused'`][]
event, and prints the reason for program suspension whenever program
execution is suspended (through breakpoints, for example):

```js
session.on('Debugger.paused', ({ params }) => {
  console.log(params.hitBreakpoints);
});
// [ '/the/file/that/has/the/breakpoint.js:11:0' ]
```

### `session.connect()`

Connects a session to the inspector back-end.

### `session.connectToMainThread()`

Connects a session to the main thread inspector back-end. An exception will
be thrown if this API was not called on a Worker thread.

### `session.disconnect()`

Immediately close the session. All pending message callbacks will be called
with an error. [`session.connect()`][] will need to be called to be able to send
messages again. Reconnected session will lose all inspector state, such as
enabled agents or configured breakpoints.

### `session.post(method[, params][, callback])`

* `method` {string}
* `params` {Object}
* `callback` {Function}

Posts a message to the inspector back-end. `callback` will be notified when
a response is received. `callback` is a function that accepts two optional
arguments: error and message-specific result.

```js
session.post('Runtime.evaluate', { expression: '2 + 2' },
             (error, { result }) => console.log(result));
// Output: { type: 'number', value: 4, description: '4' }
```

The latest version of the V8 inspector protocol is published on the
[Chrome DevTools Protocol Viewer][].

Node.js inspector supports all the Chrome DevTools Protocol domains declared
by V8. Chrome DevTools Protocol domain provides an interface for interacting
with one of the runtime agents used to inspect the application state and listen
to the run-time events.

You can not set `reportProgress` to `true` when sending a
`HeapProfiler.takeHeapSnapshot` or `HeapProfiler.stopTrackingHeapObjects`
command to V8.

#### Example usage

Apart from the debugger, various V8 Profilers are available through the DevTools
protocol.

### CPU profiler

Here's an example showing how to use the [CPU Profiler][]:

```js
const inspector = require('node:inspector');
const fs = require('node:fs');
const session = new inspector.Session();
session.connect();

session.post('Profiler.enable', () => {
  session.post('Profiler.start', () => {
    // Invoke business logic under measurement here...

// some time later...
    session.post('Profiler.stop', (err, { profile }) => {
      // Write profile to disk, upload, etc.
      if (!err) {
        fs.writeFileSync('./profile.cpuprofile', JSON.stringify(profile));
      }
    });
  });
});
```

### Heap profiler

Here's an example showing how to use the [Heap Profiler][]:

```js
const inspector = require('node:inspector');
const fs = require('node:fs');
const session = new inspector.Session();

const fd = fs.openSync('profile.heapsnapshot', 'w');

session.connect();

session.on('HeapProfiler.addHeapSnapshotChunk', (m) => {
  fs.writeSync(fd, m.params.chunk);
});

session.post('HeapProfiler.takeHeapSnapshot', null, (err, r) => {
  console.log('HeapProfiler.takeHeapSnapshot done:', err, r);
  session.disconnect();
  fs.closeSync(fd);
});
```

[CPU Profiler]: https://chromedevtools.github.io/devtools-protocol/v8/Profiler
[Chrome DevTools Protocol Viewer]: https://chromedevtools.github.io/devtools-protocol/v8/
[Heap Profiler]: https://chromedevtools.github.io/devtools-protocol/v8/HeapProfiler
[`'Debugger.paused'`]: https://chromedevtools.github.io/devtools-protocol/v8/Debugger#event-paused
[`session.connect()`]: #sessionconnect
[security warning]: cli.md#warning-binding-inspector-to-a-public-ipport-combination-is-insecure