node/test/node-api
Joyee Cheung 472edc775d
src: disambiguate terms used to refer to builtins and addons
The term "native module" dates back to some of the oldest code
in the code base. Within the context of Node.js core it usually
refers to modules that are native to Node.js (e.g. fs, http),
but it can cause confusion for people who don't work on this
part of the code base, as "native module" can also refer to
native addons - which is even the case in some of the API
docs and error messages.

This patch tries to make the usage of these terms more consistent.
Now within the context of Node.js core:

- JavaScript scripts that are built-in to Node.js are now referred
  to as "built-in(s)". If they are available as modules,
  they can also be referred to as "built-in module(s)".
- Dynamically-linked shared objects that are loaded into
  the Node.js processes are referred to as "addons".

We will try to avoid using the term "native modules" because it could
be ambiguous.

Changes in this patch:

File names:
- node_native_module.h -> node_builtins.h,
- node_native_module.cc -> node_builtins.cc

C++ binding names:
- `native_module` -> `builtins`

`node::Environment`:
- `native_modules_without_cache` -> `builtins_without_cache`
- `native_modules_with_cache` -> `builtins_with_cache`
- `native_modules_in_snapshot` -> `builtins_in_cache`
- `native_module_require` -> `builtin_module_require`

`node::EnvSerializeInfo`:
- `native_modules` -> `builtins

`node::native_module::NativeModuleLoader`:
- `native_module` namespace -> `builtins` namespace
- `NativeModuleLoader` -> `BuiltinLoader`
- `NativeModuleRecordMap` -> `BuiltinSourceMap`
- `NativeModuleCacheMap` -> `BuiltinCodeCacheMap`
- `ModuleIds` -> `BuiltinIds`
- `ModuleCategories` -> `BuiltinCategories`
- `LoadBuiltinModuleSource` -> `LoadBuiltinSource`

`loader.js`:
- `NativeModule` -> `BuiltinModule` (the `NativeModule` name used in
  `process.moduleLoadList` is kept for compatibility)

And other clarifications in the documentation and comments.

PR-URL: https://github.com/nodejs/node/pull/44135
Fixes: https://github.com/nodejs/node/issues/44036
Reviewed-By: Jacob Smith <jacob@frende.me>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Michael Dawson <midawson@redhat.com>
Reviewed-By: Richard Lau <rlau@redhat.com>
Reviewed-By: Jiawen Geng <technicalcute@gmail.com>
Reviewed-By: Chengzhong Wu <legendecas@gmail.com>
Reviewed-By: Mohammed Keyvanzadeh <mohammadkeyvanzade94@gmail.com>
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
Reviewed-By: Jan Krems <jan.krems@gmail.com>
2022-08-09 01:36:49 +08:00
..
1_hello_world test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
test_async test: prepare for consistent comma-dangle lint rule 2021-04-01 23:14:29 -07:00
test_async_cleanup_hook node-api: define version 8 2021-03-10 16:31:16 -05:00
test_async_context test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
test_buffer test: replace gc(true) with gc({ type: 'minor' }) 2022-06-21 22:54:09 +01:00
test_callback_scope test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
test_cleanup_hook test: convert most N-API tests from C++ to C 2020-08-05 14:21:51 -07:00
test_env_teardown_gc node-api: stop ref gc during environment teardown 2021-03-18 20:40:59 -07:00
test_exception test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
test_fatal test: enable no-empty ESLint rule 2022-02-05 12:58:32 +00:00
test_fatal_exception test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
test_general src: disambiguate terms used to refer to builtins and addons 2022-08-09 01:36:49 +08:00
test_init_order node-api,src: fix module registration in MSVC C++ 2022-04-07 09:40:07 -04:00
test_instance_data test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
test_make_callback test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
test_make_callback_recurse test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
test_null_init
test_policy test: prepare for consistent comma-dangle lint rule 2021-04-01 23:14:29 -07:00
test_threadsafe_function node-api: emit uncaught-exception on unhandled tsfn callbacks 2022-05-27 13:32:08 -04:00
test_uv_loop test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
test_worker_buffer_callback test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
test_worker_terminate test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
test_worker_terminate_finalization test: rename n-api to node-api 2021-02-06 05:03:38 -08:00
.gitignore
node-api.status test: mark flaky tests on smartos 2022-06-28 18:06:48 +01:00
testcfg.py