embedding: allow creating context within inspectable node::Environment

src/api/environment.cc

@@ -399,6 +399,40 @@ Local<Context> NewContext(Isolate* isolate,
   return context;
 }
 
+NewContextOptions::NewContextOptions() {
+  initialize = false;
+  microtask_queue = nullptr;
+}
+
+Local<Context> NewContext(Environment* env,
+                          Local<ObjectTemplate> object_template,
+                          const NewContextOptions& options) {
+  auto context = Context::New(
+    env->isolate(),
+    nullptr,
+    object_template,
+    v8::MaybeLocal<v8::Value>(),
+    v8::DeserializeInternalFieldsCallback(),
+    options.microtask_queue);
+  if (context.IsEmpty()) return context;
+
+  // Call InitializeContext only if initialize options is true
+  if (options.initialize && !InitializeContext(context)) {
+    return Local<Context>();
+  }
+
+  ContextInfo info(options.debug_name);
+  info.origin = options.debug_origin;
+
+  // Inspector agent is an (optional) member of node::Environment.
+  // This notifies the environment's inspector agent for the new context.
+  // Also assigns methods required for Environment::GetCurrent(context) to work.
+  // The latter is require for properly processing stack traces in node.
+  env->AssignToContext(context, info);
+
+  return context;
+}
+
 // This runs at runtime, regardless of whether the context
 // is created from a snapshot.
 void InitializeContextRuntime(Local<Context> context) {

src/node.h

@@ -362,6 +362,32 @@ NODE_EXTERN v8::Local<v8::Context> NewContext(
     v8::Local<v8::ObjectTemplate> object_template =
         v8::Local<v8::ObjectTemplate>());
 
+// Preferred way to add additional options to node::NewContext below
+// We can add more fields (as needed) later, without changing the
+// interface of node::NewContext.
+struct NewContextOptions {
+  NewContextOptions();
+  // If false creates "pure" context as created by V8
+  // If true, setup node specific initialization,
+  // required for running node code (like loading modules, etc)
+  bool initialize;
+  // This parameters is passed to v8::Context::New.
+  // The default is nullptr (use the default queue from the isolate).
+  v8::MicrotaskQueue* microtask_queue;
+  // The following two parameters are passed to the inspector agent.
+  // Use them to control how the new context will appear during debugging.
+  std::string debug_name;
+  std::string debug_origin;
+};
+
+// Create a new context for an existing environment.
+// This add several fields to make inspector work properly.
+NODE_EXTERN v8::Local<v8::Context> NewContext(
+    Environment* env,
+    v8::Local<v8::ObjectTemplate> object_template =
+    v8::Local<v8::ObjectTemplate>(),
+    const NewContextOptions& options = NewContextOptions());
+
 // Runs Node.js-specific tweaks on an already constructed context
 // Return value indicates success of operation
 NODE_EXTERN bool InitializeContext(v8::Local<v8::Context> context);