Gecko [ betsfootball.net ]

Name	Size	Permission	Date
assets	[ DIR ]	drwxr-xr-x	2025-04-07 20:36
addons.html	106.29 KB	-rw-r--r--	2024-04-10 12:46
addons.json.gz	10.96 KB	-rw-r--r--	2024-04-10 12:46
addons.md	39.78 KB	-rw-r--r--	2024-04-10 12:46
all.html	7.64 MB	-rw-r--r--	2024-04-10 12:46
all.json.gz	931.76 KB	-rw-r--r--	2024-04-10 12:46
assert.html	192.08 KB	-rw-r--r--	2024-04-10 12:46
assert.json.gz	13.09 KB	-rw-r--r--	2024-04-10 12:46
assert.md	66.87 KB	-rw-r--r--	2024-04-10 12:46
async_context.html	84.69 KB	-rw-r--r--	2024-04-10 12:46
async_context.json.gz	7.15 KB	-rw-r--r--	2024-04-10 12:46
async_context.md	25.02 KB	-rw-r--r--	2024-04-10 12:46
async_hooks.html	87.84 KB	-rw-r--r--	2024-04-10 12:46
async_hooks.json.gz	9.82 KB	-rw-r--r--	2024-04-10 12:46
async_hooks.md	30.51 KB	-rw-r--r--	2024-04-10 12:46
buffer.html	479.59 KB	-rw-r--r--	2024-04-10 12:46
buffer.json.gz	28.94 KB	-rw-r--r--	2024-04-10 12:46
buffer.md	149.19 KB	-rw-r--r--	2024-04-10 12:46
child_process.html	169.7 KB	-rw-r--r--	2024-04-10 12:46
child_process.json.gz	20.87 KB	-rw-r--r--	2024-04-10 12:46
child_process.md	70.46 KB	-rw-r--r--	2024-04-10 12:46
cli.html	190.71 KB	-rw-r--r--	2024-04-10 12:46
cli.json.gz	29.53 KB	-rw-r--r--	2024-04-10 12:46
cli.md	83.21 KB	-rw-r--r--	2024-04-10 12:46
cluster.html	91.15 KB	-rw-r--r--	2024-04-10 12:46
cluster.json.gz	9.48 KB	-rw-r--r--	2024-04-10 12:46
cluster.md	28.84 KB	-rw-r--r--	2024-04-10 12:46
console.html	60 KB	-rw-r--r--	2024-04-10 12:46
console.json.gz	6.06 KB	-rw-r--r--	2024-04-10 12:46
console.md	16.5 KB	-rw-r--r--	2024-04-10 12:46
corepack.html	24.03 KB	-rw-r--r--	2024-04-10 12:46
corepack.json.gz	2.81 KB	-rw-r--r--	2024-04-10 12:46
corepack.md	5.84 KB	-rw-r--r--	2024-04-10 12:46
crypto.html	528.53 KB	-rw-r--r--	2024-04-10 12:46
crypto.json.gz	46.51 KB	-rw-r--r--	2024-04-10 12:46
crypto.md	196.46 KB	-rw-r--r--	2024-04-10 12:46
debugger.html	28.73 KB	-rw-r--r--	2024-04-10 12:46
debugger.json.gz	3.12 KB	-rw-r--r--	2024-04-10 12:46
debugger.md	7.02 KB	-rw-r--r--	2024-04-10 12:46
deprecations.html	207.23 KB	-rw-r--r--	2024-04-10 12:46
deprecations.json.gz	25.03 KB	-rw-r--r--	2024-04-10 12:46
deprecations.md	102.53 KB	-rw-r--r--	2024-04-10 12:46
dgram.html	90.78 KB	-rw-r--r--	2024-04-10 12:46
dgram.json.gz	10.2 KB	-rw-r--r--	2024-04-10 12:46
dgram.md	31.03 KB	-rw-r--r--	2024-04-10 12:46
diagnostics_channel.html	98.54 KB	-rw-r--r--	2024-04-10 12:46
diagnostics_channel.json.gz	7.72 KB	-rw-r--r--	2024-04-10 12:46
diagnostics_channel.md	31.55 KB	-rw-r--r--	2024-04-10 12:46
dns.html	131.54 KB	-rw-r--r--	2024-04-10 12:46
dns.json.gz	15.84 KB	-rw-r--r--	2024-04-10 12:46
dns.md	52.41 KB	-rw-r--r--	2024-04-10 12:46
documentation.html	26.34 KB	-rw-r--r--	2024-04-10 12:46
documentation.json.gz	2.45 KB	-rw-r--r--	2024-04-10 12:46
documentation.md	5.28 KB	-rw-r--r--	2024-04-10 12:46
domain.html	49.05 KB	-rw-r--r--	2024-04-10 12:46
domain.json.gz	6.2 KB	-rw-r--r--	2024-04-10 12:46
domain.md	15.21 KB	-rw-r--r--	2024-04-10 12:46
embedding.html	26.38 KB	-rw-r--r--	2024-04-10 12:46
embedding.json.gz	3.01 KB	-rw-r--r--	2024-04-10 12:46
embedding.md	6.65 KB	-rw-r--r--	2024-04-10 12:46
errors.html	292.27 KB	-rw-r--r--	2024-04-10 12:46
errors.json.gz	43.19 KB	-rw-r--r--	2024-04-10 12:46
errors.md	99.68 KB	-rw-r--r--	2024-04-10 12:46
esm.html	91.64 KB	-rw-r--r--	2024-04-10 12:46
esm.json.gz	15.35 KB	-rw-r--r--	2024-04-10 12:46
esm.md	42.55 KB	-rw-r--r--	2024-04-10 12:46
events.html	232.26 KB	-rw-r--r--	2024-04-10 12:46
events.json.gz	17.43 KB	-rw-r--r--	2024-04-10 12:46
events.md	67.11 KB	-rw-r--r--	2024-04-10 12:46
fs.html	643.05 KB	-rw-r--r--	2024-04-10 12:46
fs.json.gz	68.59 KB	-rw-r--r--	2024-04-10 12:46
fs.md	254.65 KB	-rw-r--r--	2024-04-10 12:46
globals.html	89.01 KB	-rw-r--r--	2024-04-10 12:46
globals.json.gz	10.65 KB	-rw-r--r--	2024-04-10 12:46
globals.md	25.62 KB	-rw-r--r--	2024-04-10 12:46
http.html	304.7 KB	-rw-r--r--	2024-04-10 12:46
http.json.gz	36.39 KB	-rw-r--r--	2024-04-10 12:46
http.md	115.14 KB	-rw-r--r--	2024-04-10 12:46
http2.html	326.42 KB	-rw-r--r--	2024-04-10 12:46
http2.json.gz	40.42 KB	-rw-r--r--	2024-04-10 12:46
http2.md	133.89 KB	-rw-r--r--	2024-04-10 12:46
https.html	58.08 KB	-rw-r--r--	2024-04-10 12:46
https.json.gz	5.82 KB	-rw-r--r--	2024-04-10 12:46
https.md	16.71 KB	-rw-r--r--	2024-04-10 12:46
index.html	13.19 KB	-rw-r--r--	2024-04-10 12:46
index.json	54 B	-rw-r--r--	2024-04-10 12:46
index.md	1.97 KB	-rw-r--r--	2024-04-10 12:46
inspector.html	52.55 KB	-rw-r--r--	2024-04-10 12:46
inspector.json.gz	4.55 KB	-rw-r--r--	2024-04-10 12:46
inspector.md	13.54 KB	-rw-r--r--	2024-04-10 12:46
intl.html	33.63 KB	-rw-r--r--	2024-04-10 12:46
intl.json.gz	4.12 KB	-rw-r--r--	2024-04-10 12:46
intl.md	11.49 KB	-rw-r--r--	2024-04-10 12:46
module.html	98.98 KB	-rw-r--r--	2024-04-10 12:46
module.json.gz	12.75 KB	-rw-r--r--	2024-04-10 12:46
module.md	35.64 KB	-rw-r--r--	2024-04-10 12:46
modules.html	81.33 KB	-rw-r--r--	2024-04-10 12:46
modules.json.gz	12.71 KB	-rw-r--r--	2024-04-10 12:46
modules.md	33.13 KB	-rw-r--r--	2024-04-10 12:46
n-api.html	414.92 KB	-rw-r--r--	2024-04-10 12:46
n-api.json.gz	53.65 KB	-rw-r--r--	2024-04-10 12:46
n-api.md	226.71 KB	-rw-r--r--	2024-04-10 12:46
net.html	153.4 KB	-rw-r--r--	2024-04-10 12:46
net.json.gz	19.3 KB	-rw-r--r--	2024-04-10 12:46
net.md	55.99 KB	-rw-r--r--	2024-04-10 12:46
os.html	72.49 KB	-rw-r--r--	2024-04-10 12:46
os.json.gz	8.91 KB	-rw-r--r--	2024-04-10 12:46
os.md	35.56 KB	-rw-r--r--	2024-04-10 12:46
packages.html	101.84 KB	-rw-r--r--	2024-04-10 12:46
packages.json.gz	15.6 KB	-rw-r--r--	2024-04-10 12:46
packages.md	47.05 KB	-rw-r--r--	2024-04-10 12:46
path.html	54.23 KB	-rw-r--r--	2024-04-10 12:46
path.json.gz	5.15 KB	-rw-r--r--	2024-04-10 12:46
path.md	15.68 KB	-rw-r--r--	2024-04-10 12:46
perf_hooks.html	155 KB	-rw-r--r--	2024-04-10 12:46
perf_hooks.json.gz	13.02 KB	-rw-r--r--	2024-04-10 12:46
perf_hooks.md	50.26 KB	-rw-r--r--	2024-04-10 12:46
permissions.html	55.66 KB	-rw-r--r--	2024-04-10 12:46
permissions.json.gz	7.74 KB	-rw-r--r--	2024-04-10 12:46
permissions.md	20.58 KB	-rw-r--r--	2024-04-10 12:46
policy.html	14.78 KB	-rw-r--r--	2024-04-10 12:46
policy.json	476 B	-rw-r--r--	2024-04-10 12:46
policy.md	222 B	-rw-r--r--	2024-04-10 12:46
process.html	298.54 KB	-rw-r--r--	2024-04-10 12:46
process.json.gz	32.32 KB	-rw-r--r--	2024-04-10 12:46
process.md	109.77 KB	-rw-r--r--	2024-04-10 12:46
punycode.html	26.81 KB	-rw-r--r--	2024-04-10 12:46
punycode.json.gz	2 KB	-rw-r--r--	2024-04-10 12:46
punycode.md	4.17 KB	-rw-r--r--	2024-04-10 12:46
querystring.html	29.11 KB	-rw-r--r--	2024-04-10 12:46
querystring.json.gz	2.65 KB	-rw-r--r--	2024-04-10 12:46
querystring.md	5.55 KB	-rw-r--r--	2024-04-10 12:46
readline.html	105.63 KB	-rw-r--r--	2024-04-10 12:46
readline.json.gz	11.63 KB	-rw-r--r--	2024-04-10 12:46
readline.md	38.86 KB	-rw-r--r--	2024-04-10 12:46
repl.html	69.37 KB	-rw-r--r--	2024-04-10 12:46
repl.json.gz	10 KB	-rw-r--r--	2024-04-10 12:46
repl.md	23.69 KB	-rw-r--r--	2024-04-10 12:46
report.html	82.12 KB	-rw-r--r--	2024-04-10 12:46
report.json.gz	6.39 KB	-rw-r--r--	2024-04-10 12:46
report.md	18.83 KB	-rw-r--r--	2024-04-10 12:46
single-executable-applications.html	43.25 KB	-rw-r--r--	2024-04-10 12:46
single-executable-applications.json.gz	5.6 KB	-rw-r--r--	2024-04-10 12:46
single-executable-applications.md	14.57 KB	-rw-r--r--	2024-04-10 12:46
stream.html	397.5 KB	-rw-r--r--	2024-04-10 12:46
stream.json.gz	51.21 KB	-rw-r--r--	2024-04-10 12:46
stream.md	146.23 KB	-rw-r--r--	2024-04-10 12:46
string_decoder.html	24.02 KB	-rw-r--r--	2024-04-10 12:46
string_decoder.json.gz	1.55 KB	-rw-r--r--	2024-04-10 12:46
string_decoder.md	2.9 KB	-rw-r--r--	2024-04-10 12:46
synopsis.html	19.55 KB	-rw-r--r--	2024-04-10 12:46
synopsis.json	2.96 KB	-rw-r--r--	2024-04-10 12:46
synopsis.md	2.11 KB	-rw-r--r--	2024-04-10 12:46
test.html	270.6 KB	-rw-r--r--	2024-04-10 12:46
test.json.gz	22.87 KB	-rw-r--r--	2024-04-10 12:46
test.md	90.96 KB	-rw-r--r--	2024-04-10 12:46
timers.html	57.88 KB	-rw-r--r--	2024-04-10 12:46
timers.json.gz	5.29 KB	-rw-r--r--	2024-04-10 12:46
timers.md	15.84 KB	-rw-r--r--	2024-04-10 12:46
tls.html	181.63 KB	-rw-r--r--	2024-04-10 12:46
tls.json.gz	32.68 KB	-rw-r--r--	2024-04-10 12:46
tls.md	89.26 KB	-rw-r--r--	2024-04-10 12:46
tracing.html	34.95 KB	-rw-r--r--	2024-04-10 12:46
tracing.json.gz	3.47 KB	-rw-r--r--	2024-04-10 12:46
tracing.md	8.52 KB	-rw-r--r--	2024-04-10 12:46
tty.html	37.52 KB	-rw-r--r--	2024-04-10 12:46
tty.json.gz	3.72 KB	-rw-r--r--	2024-04-10 12:46
tty.md	8.91 KB	-rw-r--r--	2024-04-10 12:46
url.html	152.81 KB	-rw-r--r--	2024-04-10 12:46
url.json.gz	15.87 KB	-rw-r--r--	2024-04-10 12:46
url.md	54.66 KB	-rw-r--r--	2024-04-10 12:46
util.html	290.8 KB	-rw-r--r--	2024-04-10 12:46
util.json.gz	26.7 KB	-rw-r--r--	2024-04-10 12:46
util.md	97.56 KB	-rw-r--r--	2024-04-10 12:46
v8.html	113.98 KB	-rw-r--r--	2024-04-10 12:46
v8.json.gz	12.1 KB	-rw-r--r--	2024-04-10 12:46
v8.md	35.35 KB	-rw-r--r--	2024-04-10 12:46
vm.html	161 KB	-rw-r--r--	2024-04-10 12:46
vm.json.gz	19.23 KB	-rw-r--r--	2024-04-10 12:46
vm.md	68.09 KB	-rw-r--r--	2024-04-10 12:46
wasi.html	31.38 KB	-rw-r--r--	2024-04-10 12:46
wasi.json.gz	3.48 KB	-rw-r--r--	2024-04-10 12:46
wasi.md	8.2 KB	-rw-r--r--	2024-04-10 12:46
webcrypto.html	152.64 KB	-rw-r--r--	2024-04-10 12:46
webcrypto.json.gz	9.84 KB	-rw-r--r--	2024-04-10 12:46
webcrypto.md	45.9 KB	-rw-r--r--	2024-04-10 12:46
webstreams.html	157.4 KB	-rw-r--r--	2024-04-10 12:46
webstreams.json.gz	10.44 KB	-rw-r--r--	2024-04-10 12:46
webstreams.md	39 KB	-rw-r--r--	2024-04-10 12:46
worker_threads.html	117.56 KB	-rw-r--r--	2024-04-10 12:46
worker_threads.json.gz	14.92 KB	-rw-r--r--	2024-04-10 12:46
worker_threads.md	44.67 KB	-rw-r--r--	2024-04-10 12:46
zlib.html	109.42 KB	-rw-r--r--	2024-04-10 12:46
zlib.json.gz	10.34 KB	-rw-r--r--	2024-04-10 12:46
zlib.md	35.1 KB	-rw-r--r--	2024-04-10 12:46

Rename

# C++ embedder API

Node.js provides a number of C++ APIs that can be used to execute JavaScript
in a Node.js environment from other C++ software.

The documentation for these APIs can be found in [src/node.h][] in the Node.js
source tree. In addition to the APIs exposed by Node.js, some required concepts
are provided by the V8 embedder API.

Because using Node.js as an embedded library is different from writing code
that is executed by Node.js, breaking changes do not follow typical Node.js
[deprecation policy][] and may occur on each semver-major release without prior
warning.

## Example embedding application

The following sections will provide an overview over how to use these APIs
to create an application from scratch that will perform the equivalent of
`node -e <code>`, i.e. that will take a piece of JavaScript and run it in
a Node.js-specific environment.

The full code can be found [in the Node.js source tree][embedtest.cc].

### Setting up per-process state

Node.js requires some per-process state management in order to run:

* Arguments parsing for Node.js [CLI options][],
* V8 per-process requirements, such as a `v8::Platform` instance.

The following example shows how these can be set up. Some class names are from
the `node` and `v8` C++ namespaces, respectively.

```cpp
int main(int argc, char** argv) {
  argv = uv_setup_args(argc, argv);
  std::vector<std::string> args(argv, argv + argc);
  // Parse Node.js CLI options, and print any errors that have occurred while
  // trying to parse them.
  std::unique_ptr<node::InitializationResult> result =
      node::InitializeOncePerProcess(args, {
        node::ProcessInitializationFlags::kNoInitializeV8,
        node::ProcessInitializationFlags::kNoInitializeNodeV8Platform
      });

for (const std::string& error : result->errors())
    fprintf(stderr, "%s: %s\n", args[0].c_str(), error.c_str());
  if (result->early_return() != 0) {
    return result->exit_code();
  }

// Create a v8::Platform instance. `MultiIsolatePlatform::Create()` is a way
  // to create a v8::Platform instance that Node.js can use when creating
  // Worker threads. When no `MultiIsolatePlatform` instance is present,
  // Worker threads are disabled.
  std::unique_ptr<MultiIsolatePlatform> platform =
      MultiIsolatePlatform::Create(4);
  V8::InitializePlatform(platform.get());
  V8::Initialize();

// See below for the contents of this function.
  int ret = RunNodeInstance(
      platform.get(), result->args(), result->exec_args());

V8::Dispose();
  V8::DisposePlatform();

node::TearDownOncePerProcess();
  return ret;
}
```

### Per-instance state

Node.js has a concept of a “Node.js instance”, that is commonly being referred
to as `node::Environment`. Each `node::Environment` is associated with:

* Exactly one `v8::Isolate`, i.e. one JS Engine instance,
* Exactly one `uv_loop_t`, i.e. one event loop, and
* A number of `v8::Context`s, but exactly one main `v8::Context`.
* One `node::IsolateData` instance that contains information that could be
  shared by multiple `node::Environment`s that use the same `v8::Isolate`.
  Currently, no testing if performed for this scenario.

In order to set up a `v8::Isolate`, an `v8::ArrayBuffer::Allocator` needs
to be provided. One possible choice is the default Node.js allocator, which
can be created through `node::ArrayBufferAllocator::Create()`. Using the Node.js
allocator allows minor performance optimizations when addons use the Node.js
C++ `Buffer` API, and is required in order to track `ArrayBuffer` memory in
[`process.memoryUsage()`][].

Additionally, each `v8::Isolate` that is used for a Node.js instance needs to
be registered and unregistered with the `MultiIsolatePlatform` instance, if one
is being used, in order for the platform to know which event loop to use
for tasks scheduled by the `v8::Isolate`.

The `node::NewIsolate()` helper function creates a `v8::Isolate`,
sets it up with some Node.js-specific hooks (e.g. the Node.js error handler),
and registers it with the platform automatically.

```cpp
int RunNodeInstance(MultiIsolatePlatform* platform,
                    const std::vector<std::string>& args,
                    const std::vector<std::string>& exec_args) {
  int exit_code = 0;

// Setup up a libuv event loop, v8::Isolate, and Node.js Environment.
  std::vector<std::string> errors;
  std::unique_ptr<CommonEnvironmentSetup> setup =
      CommonEnvironmentSetup::Create(platform, &errors, args, exec_args);
  if (!setup) {
    for (const std::string& err : errors)
      fprintf(stderr, "%s: %s\n", args[0].c_str(), err.c_str());
    return 1;
  }

Isolate* isolate = setup->isolate();
  Environment* env = setup->env();

{
    Locker locker(isolate);
    Isolate::Scope isolate_scope(isolate);
    HandleScope handle_scope(isolate);
    // The v8::Context needs to be entered when node::CreateEnvironment() and
    // node::LoadEnvironment() are being called.
    Context::Scope context_scope(setup->context());

// Set up the Node.js instance for execution, and run code inside of it.
    // There is also a variant that takes a callback and provides it with
    // the `require` and `process` objects, so that it can manually compile
    // and run scripts as needed.
    // The `require` function inside this script does *not* access the file
    // system, and can only load built-in Node.js modules.
    // `module.createRequire()` is being used to create one that is able to
    // load files from the disk, and uses the standard CommonJS file loader
    // instead of the internal-only `require` function.
    MaybeLocal<Value> loadenv_ret = node::LoadEnvironment(
        env,
        "const publicRequire ="
        "  require('node:module').createRequire(process.cwd() + '/');"
        "globalThis.require = publicRequire;"
        "require('node:vm').runInThisContext(process.argv[1]);");

if (loadenv_ret.IsEmpty())  // There has been a JS exception.
      return 1;

exit_code = node::SpinEventLoop(env).FromMaybe(1);

// node::Stop() can be used to explicitly stop the event loop and keep
    // further JavaScript from running. It can be called from any thread,
    // and will act like worker.terminate() if called from another thread.
    node::Stop(env);
  }

return exit_code;
}
```

[CLI options]: cli.md
[`process.memoryUsage()`]: process.md#processmemoryusage
[deprecation policy]: deprecations.md
[embedtest.cc]: https://github.com/nodejs/node/blob/HEAD/test/embedding/embedtest.cc
[src/node.h]: https://github.com/nodejs/node/blob/HEAD/src/node.h