GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — src: disambiguate terms used to refer to builtins and addons · nodejs/node@70bb6a3

File tree

Expand file treeCollapse file tree
Open diff view settings
Filter options
  • .github
    • CODEOWNERS
  • doc
    • api
      • deprecations.md
      • modules.md
      • n-api.md
    • contributing
      • adding-new-napi-api.md
  • lib
    • assert.js
    • internal
      • bootstrap
        • loaders.js
        • node.js
      • debugger
        • inspect_repl.js
      • main
        • mksnapshot.js
      • modules
        • cjs
          • helpers.js
          • loader.js
        • esm
          • loader.js
          • resolve.js
          • translators.js
      • process
        • pre_execution.js
      • util
        • inspect.js
    • process.js
    • repl.js
  • node.gyp
  • src
    • api
      • environment.cc
    • crypto
      • crypto_keys.cc
    • env.cc
    • env.h
    • node.cc
    • node_api.h
    • node_binding.cc
    • node_builtins.cc
    • node_builtins.h
    • node_config.cc
    • node_errors.h
    • node_external_reference.h
    • node_internals.h
    • node_main_instance.cc
    • node_snapshotable.cc
  • test
    • addons
      • force-context-aware
        • test.js
      • symlinked-module
        • test.js
    • cctest
      • test_per_process.cc
    • node-api/test_general
      • test.js
    • parallel
      • test-bootstrap-modules.js
      • test-code-cache.js
  • tools
    • js2c.py

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Dismiss banner
Expand file treeCollapse file tree
Open diff view settings
Collapse file

‎.github/CODEOWNERS‎

Copy file name to clipboardExpand all lines: .github/CODEOWNERS
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@
107107

108108
/benchmark/misc/startup.js @nodejs/startup
109109
/src/node.cc @nodejs/startup
110-
/src/node_native_module* @nodejs/startup
110+
/src/node_builtins* @nodejs/startup
111111
/src/node_snapshot* @nodejs/startup
112112
/lib/internal/bootstrap/* @nodejs/startup
113113
/tools/snapshot/* @nodejs/startup
Collapse file

‎doc/api/deprecations.md‎

Copy file name to clipboardExpand all lines: doc/api/deprecations.md
+2-2Lines changed: 2 additions & 2 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -1996,7 +1996,7 @@ changes:
19961996

19971997
Type: Compile-time
19981998

1999-
Certain versions of `node::MakeCallback` APIs available to native modules are
1999+
Certain versions of `node::MakeCallback` APIs available to native addons are
20002000
deprecated. Please use the versions of the API that accept an `async_context`
20012001
parameter.
20022002

@@ -2746,7 +2746,7 @@ changes:
27462746
Type: Documentation-only
27472747

27482748
The `node:repl` module exports a `_builtinLibs` property that contains an array
2749-
with native modules. It was incomplete so far and instead it's better to rely
2749+
of built-in modules. It was incomplete so far and instead it's better to rely
27502750
upon `require('node:module').builtinModules`.
27512751

27522752
### DEP0143: `Transform._transformState`
Collapse file

‎doc/api/modules.md‎

Copy file name to clipboardExpand all lines: doc/api/modules.md
+2-2Lines changed: 2 additions & 2 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -707,8 +707,8 @@ This does not apply to [native addons][], for which reloading will result in an
707707
error.
708708

709709
Adding or replacing entries is also possible. This cache is checked before
710-
native modules and if a name matching a native module is added to the cache,
711-
only `node:`-prefixed require calls are going to receive the native module.
710+
built-in modules and if a name matching a built-in module is added to the cache,
711+
only `node:`-prefixed require calls are going to receive the built-in module.
712712
Use with care!
713713

714714
<!-- eslint-disable node-core/no-duplicate-requires -->
Collapse file

‎doc/api/n-api.md‎

Copy file name to clipboardExpand all lines: doc/api/n-api.md
+4-4Lines changed: 4 additions & 4 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -201,9 +201,9 @@ GitHub projects using CMake.js.
201201
#### prebuildify
202202

203203
[prebuildify][] is a tool based on node-gyp. The advantage of prebuildify is
204-
that the built binaries are bundled with the native module when it's
204+
that the built binaries are bundled with the native addon when it's
205205
uploaded to npm. The binaries are downloaded from npm and are immediately
206-
available to the module user when the native module is installed.
206+
available to the module user when the native addon is installed.
207207

208208
## Usage
209209

@@ -1384,7 +1384,7 @@ callback throws an exception with no way to recover.
13841384

13851385
### Fatal errors
13861386

1387-
In the event of an unrecoverable error in a native module, a fatal error can be
1387+
In the event of an unrecoverable error in a native addon, a fatal error can be
13881388
thrown to immediately terminate the process.
13891389

13901390
#### `napi_fatal_error`
@@ -5722,7 +5722,7 @@ Returns `napi_ok` if the API succeeded.
57225722

57235723
This function gives V8 an indication of the amount of externally allocated
57245724
memory that is kept alive by JavaScript objects (i.e. a JavaScript object
5725-
that points to its own memory allocated by a native module). Registering
5725+
that points to its own memory allocated by a native addon). Registering
57265726
externally allocated memory will trigger global garbage collections more
57275727
often than it would otherwise.
57285728

Collapse file

‎doc/contributing/adding-new-napi-api.md‎

Copy file name to clipboardExpand all lines: doc/contributing/adding-new-napi-api.md
+1-1Lines changed: 1 addition & 1 deletion
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Contributing a new API to Node-API
22

3-
Node-API is the next-generation ABI-stable API for native modules.
3+
Node-API is the next-generation ABI-stable API for native addons.
44
While improving the API surface is encouraged and welcomed, the following are
55
a set of principles and guidelines to keep in mind while adding a new
66
Node-API.
Collapse file

‎lib/assert.js‎

Copy file name to clipboardExpand all lines: lib/assert.js
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ const { openSync, closeSync, readSync } = require('fs');
6565
const { inspect } = require('internal/util/inspect');
6666
const { isPromise, isRegExp } = require('internal/util/types');
6767
const { EOL } = require('internal/constants');
68-
const { NativeModule } = require('internal/bootstrap/loaders');
68+
const { BuiltinModule } = require('internal/bootstrap/loaders');
6969
const { isError } = require('internal/util');
7070

7171
const errorCache = new SafeMap();
@@ -303,7 +303,7 @@ function getErrMessage(message, fn) {
303303

304304
// Skip Node.js modules!
305305
if (StringPrototypeStartsWith(filename, 'node:') &&
306-
NativeModule.exists(StringPrototypeSlice(filename, 5))) {
306+
BuiltinModule.exists(StringPrototypeSlice(filename, 5))) {
307307
errorCache.set(identifier, undefined);
308308
return;
309309
}
Collapse file

‎lib/internal/bootstrap/loaders.js‎

Copy file name to clipboardExpand all lines: lib/internal/bootstrap/loaders.js
+16-14Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@
2424
// and have their nm_flags set to NM_F_INTERNAL.
2525
//
2626
// Internal JavaScript module loader:
27-
// - NativeModule: a minimal module system used to load the JavaScript core
27+
// - BuiltinModule: a minimal module system used to load the JavaScript core
2828
// modules found in lib/**/*.js and deps/**/*.js. All core modules are
2929
// compiled into the node binary via node_javascript.cc generated by js2c.py,
3030
// so they can be loaded faster without the cost of I/O. This class makes the
@@ -180,9 +180,9 @@ let internalBinding;
180180

181181
const loaderId = 'internal/bootstrap/loaders';
182182
const {
183-
moduleIds,
183+
builtinIds,
184184
compileFunction
185-
} = internalBinding('native_module');
185+
} = internalBinding('builtins');
186186

187187
const getOwn = (target, property, receiver) => {
188188
return ObjectPrototypeHasOwnProperty(target, property) ?
@@ -195,13 +195,13 @@ const getOwn = (target, property, receiver) => {
195195
* Be careful not to expose this to user land unless --expose-internals is
196196
* used, in which case there is no compatibility guarantee about this class.
197197
*/
198-
class NativeModule {
198+
class BuiltinModule {
199199
/**
200200
* A map from the module IDs to the module instances.
201-
* @type {Map<string, NativeModule>}
201+
* @type {Map<string, BuiltinModule>}
202202
*/
203203
static map = new SafeMap(
204-
ArrayPrototypeMap(moduleIds, (id) => [id, new NativeModule(id)])
204+
ArrayPrototypeMap(builtinIds, (id) => [id, new BuiltinModule(id)])
205205
);
206206

207207
constructor(id) {
@@ -216,7 +216,7 @@ class NativeModule {
216216
this.loading = false;
217217

218218
// The following properties are used by the ESM implementation and only
219-
// initialized when the native module is loaded by users.
219+
// initialized when the built-in module is loaded by users.
220220
/**
221221
* The C++ ModuleWrap binding used to interface with the ESM implementation.
222222
* @type {ModuleWrap|undefined}
@@ -232,7 +232,7 @@ class NativeModule {
232232
// To be called during pre-execution when --expose-internals is on.
233233
// Enables the user-land module loader to access internal modules.
234234
static exposeInternals() {
235-
for (const { 0: id, 1: mod } of NativeModule.map) {
235+
for (const { 0: id, 1: mod } of BuiltinModule.map) {
236236
// Do not expose this to user land even with --expose-internals.
237237
if (id !== loaderId) {
238238
mod.canBeRequiredByUsers = true;
@@ -241,11 +241,11 @@ class NativeModule {
241241
}
242242

243243
static exists(id) {
244-
return NativeModule.map.has(id);
244+
return BuiltinModule.map.has(id);
245245
}
246246

247247
static canBeRequiredByUsers(id) {
248-
const mod = NativeModule.map.get(id);
248+
const mod = BuiltinModule.map.get(id);
249249
return mod && mod.canBeRequiredByUsers;
250250
}
251251

@@ -327,14 +327,16 @@ class NativeModule {
327327

328328
const fn = compileFunction(id);
329329
// Arguments must match the parameters specified in
330-
// NativeModuleLoader::LookupAndCompile().
330+
// BuiltinLoader::LookupAndCompile().
331331
fn(this.exports, requireFn, this, process, internalBinding, primordials);
332332

333333
this.loaded = true;
334334
} finally {
335335
this.loading = false;
336336
}
337337

338+
// "NativeModule" is a legacy name of "BuiltinModule". We keep it
339+
// here to avoid breaking users who parse process.moduleLoadList.
338340
ArrayPrototypePush(moduleLoadList, `NativeModule ${id}`);
339341
return this.exports;
340342
}
@@ -344,7 +346,7 @@ class NativeModule {
344346
// written in CommonJS style.
345347
const loaderExports = {
346348
internalBinding,
347-
NativeModule,
349+
BuiltinModule,
348350
require: nativeModuleRequire
349351
};
350352

@@ -353,7 +355,7 @@ function nativeModuleRequire(id) {
353355
return loaderExports;
354356
}
355357

356-
const mod = NativeModule.map.get(id);
358+
const mod = BuiltinModule.map.get(id);
357359
// Can't load the internal errors module from here, have to use a raw error.
358360
// eslint-disable-next-line no-restricted-syntax
359361
if (!mod) throw new TypeError(`Missing internal module '${id}'`);
@@ -363,7 +365,7 @@ function nativeModuleRequire(id) {
363365
// Allow internal modules from dependencies to require
364366
// other modules from dependencies by providing fallbacks.
365367
function requireWithFallbackInDeps(request) {
366-
if (!NativeModule.map.has(request)) {
368+
if (!BuiltinModule.map.has(request)) {
367369
request = `internal/deps/${request}`;
368370
}
369371
return nativeModuleRequire(request);
Collapse file

‎lib/internal/bootstrap/node.js‎

Copy file name to clipboardExpand all lines: lib/internal/bootstrap/node.js
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818
// modules to use.
1919
// - `lib/internal/bootstrap/loaders.js`: to setup internal binding and
2020
// module loaders, including `process.binding()`, `process._linkedBinding()`,
21-
// `internalBinding()` and `NativeModule`.
21+
// `internalBinding()` and `BuiltinModule`.
2222
//
2323
// This file is run to bootstrap both the main thread and the worker threads.
2424
// After this file is run, certain properties are setup according to the
@@ -89,7 +89,7 @@ process.domain = null;
8989
process._exiting = false;
9090

9191
// process.config is serialized config.gypi
92-
const nativeModule = internalBinding('native_module');
92+
const nativeModule = internalBinding('builtins');
9393

9494
// TODO(@jasnell): Once this has gone through one full major
9595
// release cycle, remove the Proxy and setter and update the
Collapse file

‎lib/internal/debugger/inspect_repl.js‎

Copy file name to clipboardExpand all lines: lib/internal/debugger/inspect_repl.js
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -118,8 +118,8 @@ function extractFunctionName(description) {
118118
}
119119

120120
const {
121-
moduleIds: PUBLIC_BUILTINS,
122-
} = internalBinding('native_module');
121+
builtinIds: PUBLIC_BUILTINS,
122+
} = internalBinding('builtins');
123123
const NATIVES = internalBinding('natives');
124124
function isNativeUrl(url) {
125125
url = RegExpPrototypeSymbolReplace(/\.js$/, url, '');
Collapse file

‎lib/internal/main/mksnapshot.js‎

Copy file name to clipboardExpand all lines: lib/internal/main/mksnapshot.js
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ const {
77
} = primordials;
88

99
const binding = internalBinding('mksnapshot');
10-
const { NativeModule } = require('internal/bootstrap/loaders');
10+
const { BuiltinModule } = require('internal/bootstrap/loaders');
1111
const {
1212
compileSerializeMain,
1313
} = binding;
@@ -92,7 +92,7 @@ function supportedInUserSnapshot(id) {
9292
}
9393

9494
function requireForUserSnapshot(id) {
95-
if (!NativeModule.canBeRequiredByUsers(id)) {
95+
if (!BuiltinModule.canBeRequiredByUsers(id)) {
9696
// eslint-disable-next-line no-restricted-syntax
9797
const err = new Error(
9898
`Cannot find module '${id}'. `

0 commit comments

Comments
0 (0)
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.