Merge commit '6e92d2345e8231a44556ce7d416451f5f3e6c398' as 'engine262'

2026-08-18 13:21:55 +00:00 · 2026-03-27 10:07:29 +05:30
parent 8f26db5a1f 6e92d2345e
commit b42a69d9f8
433 changed files with 90478 additions and 0 deletions
@@ -0,0 +1,81 @@
+import type Protocol from 'devtools-protocol';
+import type { Inspector } from './index.mts';
+import {
+  CreateBuiltinFunction, CreateDataProperty, DefinePropertyOrThrow, Descriptor, OrdinaryObjectCreate, surroundingAgent, ThrowCompletion, skipDebugger, Value, type Arguments, type ManagedRealm,
+  type PlainEvaluator,
+  type PlainCompletion,
+} from '#self';
+
+const consoleMethods = [
+  'log',
+  'debug',
+  'info',
+  'error',
+  'warning',
+  'dir',
+  'dirxml',
+  'table',
+  'trace',
+  'clear',
+  'startGroup',
+  'startGroupCollapsed',
+  'endGroup',
+  'assert',
+  'profile',
+  'profileEnd',
+  'count',
+  'timeEnd',
+] as const;
+type ConsoleMethod = typeof consoleMethods[number];
+export function createConsole(
+  realm: ManagedRealm,
+  defaultBehaviour: Partial<Record<ConsoleMethod, (args: Arguments) => void | PlainCompletion<void> | PlainEvaluator<void>>> & { default?: (method: ConsoleMethod, args: Arguments) => void | PlainCompletion<void> | PlainEvaluator<void> },
+) {
+  realm.scope(() => {
+    const console = OrdinaryObjectCreate(realm.Intrinsics['%Object.prototype%']);
+    skipDebugger(DefinePropertyOrThrow(
+      realm.GlobalObject,
+      Value('console'),
+      Descriptor({
+        Configurable: Value.true,
+        Enumerable: Value.false,
+        Writable: Value.true,
+        Value: console,
+      }),
+    ));
+    consoleMethods.forEach((method) => {
+      const f = CreateBuiltinFunction(
+        function* Console(args): PlainEvaluator<Value> {
+          if (surroundingAgent.debugger_isPreviewing) {
+            return Value.undefined;
+          }
+
+          let completion;
+          if (defaultBehaviour[method]) {
+            completion = defaultBehaviour[method](args);
+          } else if (defaultBehaviour.default) {
+            completion = defaultBehaviour.default(method, args);
+          }
+
+          if (completion) {
+            if (typeof completion === 'object' && 'next' in completion) {
+              completion = yield* completion;
+            }
+            // Do not use Q(host) here. A host may return something invalid like ReturnCompletion.
+            if (completion instanceof ThrowCompletion) {
+              return completion;
+            }
+          }
+          if (realm.HostDefined.attachingInspector) {
+            (realm.HostDefined.attachingInspector as Inspector).console(realm, method as Protocol.Protocol.Runtime.ConsoleAPICalledEventType, args);
+          }
+          return Value.undefined;
+        },
+        1,
+        Value(method),
+        [],
+      );
+      skipDebugger(CreateDataProperty(console, Value(method), f));
+    });
+  });
+}