src: bootstrap prepare stack trace callback in shadow realm

Bootstrap per-realm callbacks like `prepare_stack_trace_callback` in
the ShadowRealm. This enables stack trace decoration in the ShadowRealm.
PR-URL: #47107
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>

Author: legendecas

.github/CODEOWNERS

@@ -84,7 +84,7 @@
 /doc/api/module.md@nodejs/modules@nodejs/loaders
 /doc/api/modules.md@nodejs/modules@nodejs/loaders
 /doc/api/packages.md@nodejs/modules@nodejs/loaders
-/lib/internal/bootstrap/loaders.js@nodejs/modules@nodejs/loaders
+/lib/internal/bootstrap/realm.js@nodejs/modules@nodejs/loaders
 /lib/internal/modules/*@nodejs/modules@nodejs/loaders
 /lib/internal/process/esm_loader.js@nodejs/modules@nodejs/loaders
 /lib/internal/process/execution.js@nodejs/modules@nodejs/loaders

lib/assert.js

@@ -65,7 +65,7 @@ const { openSync, closeSync, readSync } = require('fs');
 const{ inspect }=require('internal/util/inspect');
 const{ isPromise, isRegExp }=require('internal/util/types');
 const{EOL}=require('internal/constants');
-const{ BuiltinModule }=require('internal/bootstrap/loaders');
+const{ BuiltinModule }=require('internal/bootstrap/realm');
 const{ isError }=require('internal/util');
 
 consterrorCache=newSafeMap();

lib/internal/bootstrap/node.js

@@ -1,6 +1,6 @@
 // Hello, and welcome to hacking node.js!
 //
-// This file is invoked by `Realm::BootstrapNode()` in `src/node_realm.cc`,
+// This file is invoked by `Realm::BootstrapRealm()` in `src/node_realm.cc`,
 // and is responsible for setting up Node.js core before main scripts
 // under `lib/internal/main/` are executed.
 //
@@ -32,9 +32,10 @@
 // `DOMException` class.
 // - `lib/internal/per_context/messageport.js`: JS-side components of the
 // `MessagePort` implementation.
-// - `lib/internal/bootstrap/loaders.js`: this sets up internal binding and
+// - `lib/internal/bootstrap/realm.js`: this sets up internal binding and
 // module loaders, including `process.binding()`, `process._linkedBinding()`,
-// `internalBinding()` and `BuiltinModule`.
+// `internalBinding()` and `BuiltinModule`, and per-realm internal states
+// and bindings, including `prepare_stack_trace_callback`.
 //
 // The initialization done in this script is included in both the main thread
 // and the worker threads. After this, further initialization is done based
@@ -52,8 +53,6 @@
 // passed by `BuiltinLoader::CompileAndCall()`.
 /* global process, require, internalBinding, primordials */
 
-setupPrepareStackTrace();
-
 const{
  FunctionPrototypeCall,
  JSONParse,
@@ -336,25 +335,6 @@ process.emitWarning = emitWarning;
 // Note: only after this point are the timers effective
 }
 
-functionsetupPrepareStackTrace(){
-const{
- setEnhanceStackForFatalException,
- setPrepareStackTraceCallback,
-}=internalBinding('errors');
-const{
- prepareStackTrace,
-fatalExceptionStackEnhancers: {
- beforeInspector,
- afterInspector,
-},
-}=require('internal/errors');
-// Tell our PrepareStackTraceCallback passed to the V8 API
-// to call prepareStackTrace().
-setPrepareStackTraceCallback(prepareStackTrace);
-// Set the function used to enhance the error stack for printing
-setEnhanceStackForFatalException(beforeInspector,afterInspector);
-}
-
 functionsetupProcessObject(){
 constEventEmitter=require('events');
 constorigProcProto=ObjectGetPrototypeOf(process);

lib/internal/bootstrap/loaders.js lib/internal/bootstrap/realm.jslib/internal/bootstrap/loaders.js renamed to lib/internal/bootstrap/realm.js

@@ -1,3 +1,8 @@
+// This file is executed in every realm that is created by Node.js, including
+// the context of main thread, worker threads, and ShadowRealms.
+// Only per-realm internal states and bindings should be bootstrapped in this
+// file and no globals should be exposed to the user code.
+//
 // This file creates the internal module & binding loaders used by built-in
 // modules. In contrast, user land modules are loaded using
 // lib/internal/modules/cjs/loader.js (CommonJS Modules) or
@@ -30,7 +35,7 @@
 // so they can be loaded faster without the cost of I/O. This class makes the
 // lib/internal/*, deps/internal/* modules and internalBinding() available by
 // default to core modules, and lets the core modules require itself via
-// require('internal/bootstrap/loaders') even when this file is not written in
+// require('internal/bootstrap/realm') even when this file is not written in
 // CommonJS style.
 //
 // Other objects:
@@ -178,7 +183,7 @@ let internalBinding;
 };
 }
 
-constloaderId='internal/bootstrap/loaders';
+constselfId='internal/bootstrap/realm';
 const{
  builtinIds,
  compileFunction,
@@ -235,7 +240,7 @@ class BuiltinModule {
 staticexposeInternals(){
 for(const{0: id,1: mod}ofBuiltinModule.map){
 // Do not expose this to user land even with --expose-internals.
-if(id!==loaderId){
+if(id!==selfId){
 mod.canBeRequiredByUsers=true;
 }
 }
@@ -354,7 +359,7 @@ const loaderExports = {
 };
 
 functionrequireBuiltin(id){
-if(id===loaderId){
+if(id===selfId){
 returnloaderExports;
 }
 
@@ -374,5 +379,27 @@ function requireWithFallbackInDeps(request) {
 returnrequireBuiltin(request);
 }
 
+functionsetupPrepareStackTrace(){
+const{
+ setEnhanceStackForFatalException,
+ setPrepareStackTraceCallback,
+}=internalBinding('errors');
+const{
+ prepareStackTrace,
+fatalExceptionStackEnhancers: {
+ beforeInspector,
+ afterInspector,
+},
+}=requireBuiltin('internal/errors');
+// Tell our PrepareStackTraceCallback passed to the V8 API
+// to call prepareStackTrace().
+setPrepareStackTraceCallback(prepareStackTrace);
+// Set the function used to enhance the error stack for printing
+setEnhanceStackForFatalException(beforeInspector,afterInspector);
+}
+
 // Store the internal loaders in C++.
 setInternalLoaders(internalBinding,requireBuiltin);
+
+// Setup per-realm bindings.
+setupPrepareStackTrace();

lib/internal/main/mksnapshot.js

@@ -10,7 +10,7 @@ const {
 }=primordials;
 
 constbinding=internalBinding('mksnapshot');
-const{ BuiltinModule }=require('internal/bootstrap/loaders');
+const{ BuiltinModule }=require('internal/bootstrap/realm');
 const{
  getEmbedderEntryFunction,
  compileSerializeMain,

lib/internal/modules/cjs/loader.js

@@ -75,7 +75,7 @@ module.exports = {
  initializeCJS,
 };
 
-const{ BuiltinModule }=require('internal/bootstrap/loaders');
+const{ BuiltinModule }=require('internal/bootstrap/realm');
 const{
  maybeCacheSourceMap,
 }=require('internal/source_map/source_map_cache');

lib/internal/modules/esm/hooks.js

@@ -190,7 +190,7 @@ class Hooks {
 filename: '<preload>',
 },
 );
-const{ BuiltinModule }=require('internal/bootstrap/loaders');
+const{ BuiltinModule }=require('internal/bootstrap/realm');
 // We only allow replacing the importMetaInitializer during preload;
 // after preload is finished, we disable the ability to replace it.
 //

lib/internal/modules/esm/resolve.js

@@ -24,7 +24,7 @@ const {
  StringPrototypeStartsWith,
 }=primordials;
 constinternalFS=require('internal/fs/utils');
-const{ BuiltinModule }=require('internal/bootstrap/loaders');
+const{ BuiltinModule }=require('internal/bootstrap/realm');
 const{
  realpathSync,
  statSync,

lib/internal/modules/helpers.js

@@ -17,7 +17,7 @@ const {
 ERR_MANIFEST_DEPENDENCY_MISSING,
 ERR_UNKNOWN_BUILTIN_MODULE,
 }=require('internal/errors').codes;
-const{ BuiltinModule }=require('internal/bootstrap/loaders');
+const{ BuiltinModule }=require('internal/bootstrap/realm');
 
 const{ validateString }=require('internal/validators');
 constpath=require('path');

lib/internal/process/pre_execution.js

@@ -351,7 +351,7 @@ function initializeReport() {
 functionsetupDebugEnv(){
 require('internal/util/debuglog').initializeDebugEnv(process.env.NODE_DEBUG);
 if(getOptionValue('--expose-internals')){
-require('internal/bootstrap/loaders').BuiltinModule.exposeInternals();
+require('internal/bootstrap/realm').BuiltinModule.exposeInternals();
 }
 }