@engine262/engine262 0.0.1-0574c6b92a2925de851f895445b7cfd7e97cc0ba

package/lib/node/inspector.mjs

@@ -0,0 +1,112 @@
+import http from 'node:http';
+import https from 'node:https';
+import { WebSocketServer } from 'ws';
+import packageJson from '../../package.json' with { type: 'json' };
+// Note: typescript will not copy json files, so it will not appear in the lib directory
+// eslint-disable-next-line import/no-useless-path-segments
+import protocol from '../../lib-src/inspector/js_protocol.json' with { type: 'json' };
+import { Inspector } from "../inspector/index.mjs";
+const ANSI = {
+    reset: '\u001b[0m',
+    red: '\u001b[31m',
+    green: '\u001b[32m',
+    yellow: '\u001b[33m',
+    blue: '\u001b[34m',
+};
+export class NodeWebsocketInspector extends Inspector {
+    _server;
+    _ws;
+    isDebug = false;
+    send(data) {
+        const s = JSON.stringify(data);
+        this._ws.clients.forEach((ws) => {
+            ws.send(s);
+        });
+    }
+    constructor(server, isDebug) {
+        super();
+        this._server = server;
+        const ws = new WebSocketServer({ server });
+        this._ws = ws;
+        ws.on('connection', (ws) => {
+            const send = (obj) => {
+                const s = JSON.stringify(obj);
+                ws.send(s);
+            };
+            const sendEvent = Object.create(new Proxy({}, {
+                get: (_, key) => {
+                    const f = (params) => {
+                        send({ method: key, params });
+                    };
+                    Object.defineProperty(sendEvent, key, { value: key });
+                    return f;
+                },
+            }));
+            ws.on('message', (data) => {
+                const { id, method, params } = JSON.parse(data);
+                if (isDebug) {
+                    process.stdout.write(`${ANSI.green}${method}${ANSI.reset}: ${JSON.stringify(params)}\n`);
+                }
+                this.onMessage(id, method, params);
+            });
+        });
+    }
+    static inspectorHTTPServer(req, res) {
+        if (req.method !== 'GET') {
+            res.writeHead(405);
+            res.end();
+            return;
+        }
+        const json = (obj) => {
+            const s = JSON.stringify(obj);
+            res.writeHead(200, {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(s),
+            });
+            res.end(s);
+        };
+        switch (req.url) {
+            case '/json':
+            case '/json/list':
+                json([{
+                        description: `${packageJson.name} instance`,
+                        devtoolsFrontendUrl: 'chrome-devtools://devtools/bundled/js_app.html?experiments=true&v8only=true&ws=localhost:9229/',
+                        devtoolsFrontendUrlCompat: 'chrome-devtools://devtools/bundled/inspector.html?experiments=true&v8only=true&ws=localhost:9229/',
+                        faviconUrl: 'https://avatars0.githubusercontent.com/u/51185628',
+                        id: 'inspector.0',
+                        title: 'engine262',
+                        type: 'node',
+                        url: `file://${process.cwd()}`,
+                        webSocketDebuggerUrl: 'ws://localhost:9229/',
+                    }]);
+                break;
+            case '/json/version':
+                json({
+                    'Browser': `${packageJson.name}/v${packageJson.version}`,
+                    'Protocol-Version': `${protocol.version.major}.${protocol.version.minor}`,
+                });
+                break;
+            case '/json/protocol':
+                json(protocol);
+                break;
+            default:
+                res.writeHead(404);
+                res.end();
+                break;
+        }
+    }
+    static new(port = 9229, host = '127.0.0.1', isDebug = !!process.env.DEBUG) {
+        const server = http.createServer(NodeWebsocketInspector.inspectorHTTPServer);
+        const inspector = new NodeWebsocketInspector(server, isDebug);
+        return new Promise((resolve) => {
+            server.listen(port, host, () => {
+                resolve(inspector);
+            });
+        });
+    }
+    stop() {
+        this._server.close();
+        this._ws.close();
+    }
+}
+//# sourceMappingURL=inspector.mjs.map

package/lib/node/inspector.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.mjs","sourceRoot":"","sources":["../../lib-src/node/inspector.mts"],"names":[],"mappings":"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"}

package/lib/node/module.d.mts

@@ -0,0 +1,7 @@
+import { ManagedRealm, NullValue, Realm } from '#self';
+export declare function createLoadImportedModule(getCache?: (realm: ManagedRealm) => Map<string, import("#self").AbstractModuleRecord> | undefined): {
+    loadImportedModule: (referrer: import("#self").AbstractModuleRecord | import("#self").ScriptRecord | NullValue | Realm, specifier: string, attributes: Map<string, string>, hostDefined: import("#self").ModuleRecordHostDefined | undefined, finish: (res: import("#self").PlainCompletion<import("#self").AbstractModuleRecord>) => void) => void;
+    loadImportedModuleSync: (referrer: import("#self").AbstractModuleRecord | import("#self").ScriptRecord | NullValue | Realm, specifier: string, attributes: Map<string, string>, hostDefined: import("#self").ModuleRecordHostDefined | undefined, finish: (res: import("#self").PlainCompletion<import("#self").AbstractModuleRecord>) => void) => void;
+};
+export declare const loadImportedModule: (referrer: import("#self").AbstractModuleRecord | import("#self").ScriptRecord | NullValue | Realm, specifier: string, attributes: Map<string, string>, hostDefined: import("#self").ModuleRecordHostDefined | undefined, finish: (res: import("#self").PlainCompletion<import("#self").AbstractModuleRecord>) => void) => void, loadImportedModuleSync: (referrer: import("#self").AbstractModuleRecord | import("#self").ScriptRecord | NullValue | Realm, specifier: string, attributes: Map<string, string>, hostDefined: import("#self").ModuleRecordHostDefined | undefined, finish: (res: import("#self").PlainCompletion<import("#self").AbstractModuleRecord>) => void) => void;
+//# sourceMappingURL=module.d.mts.map

package/lib/node/module.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.mts","sourceRoot":"","sources":["../../lib-src/node/module.mts"],"names":[],"mappings":"AAGA,OAAO,EACE,YAAY,EAAE,SAAS,EAAE,KAAK,EACtC,MAAM,OAAO,CAAC;AAEf,wBAAgB,wBAAwB,CAAC,QAAQ,IAAI,OAAO,YAAY,kEAAoC;;;EA2E3G;AAED,eAAO,MAAQ,kBAAkB,mUAAE,sBAAsB,iUAA+B,CAAC"}

package/lib/node/module.mjs

@@ -0,0 +1,79 @@
+import { readFile } from 'node:fs/promises';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { evalQ, ManagedRealm, NullValue, Realm, Throw, ThrowCompletion, } from '#self';
+export function createLoadImportedModule(getCache = (realm) => realm.HostDefined.resolverCache) {
+    const validateType = (attributes, finish) => {
+        const type = attributes.get('type');
+        if (type && type !== 'json') {
+            finish(Throw('TypeError', 'UnsupportedModuleType', type));
+            return false;
+        }
+        return true;
+    };
+    const parseModule = (realm, resolved, attributes, source) => (attributes.get('type') === 'json' || resolved.endsWith('.json')
+        ? realm.createJSONModule(resolved, source)
+        : realm.createSourceTextModule(resolved, source));
+    const loadImportedModule = (referrer, specifier, attributes, _hostDefined, finish) => {
+        if (referrer instanceof Realm || referrer instanceof NullValue) {
+            throw new Error('Internal error: loadImportedModule called without a ScriptOrModule referrer.');
+        }
+        const realm = referrer.Realm;
+        const cache = getCache(realm);
+        if (!validateType(attributes, finish)) {
+            return;
+        }
+        evalQ(async (Q) => {
+            const base = path.dirname(referrer.HostDefined.specifier);
+            const resolved = path.resolve(base, specifier);
+            if (cache?.has(resolved)) {
+                finish(cache.get(resolved));
+                return;
+            }
+            try {
+                const source = await readFile(resolved, 'utf8');
+                const m = Q(parseModule(realm, resolved, attributes, source));
+                cache?.set(resolved, m);
+                finish(m);
+            }
+            catch (error) {
+                finish(Throw('SyntaxError', 'CouldNotResolveModule', specifier));
+            }
+        });
+    };
+    const loadImportedModuleSync = (referrer, specifier, attributes, _hostDefined, finish) => {
+        if (referrer instanceof Realm || referrer instanceof NullValue) {
+            throw new Error('Internal error: loadImportedModule called without a ScriptOrModule referrer.');
+        }
+        const realm = referrer.Realm;
+        const cache = getCache(realm);
+        if (!validateType(attributes, finish)) {
+            return;
+        }
+        evalQ((Q) => {
+            const base = path.dirname(referrer.HostDefined.specifier);
+            const resolved = path.resolve(base, specifier);
+            if (cache?.has(resolved)) {
+                finish(cache.get(resolved));
+                return;
+            }
+            try {
+                const source = readFileSync(resolved, 'utf8');
+                const m = Q(parseModule(realm, resolved, attributes, source));
+                cache?.set(resolved, m);
+                finish(m);
+            }
+            catch (error) {
+                if (error instanceof ThrowCompletion) {
+                    finish(error);
+                }
+                else {
+                    finish(Throw('SyntaxError', 'CouldNotResolveModule', specifier));
+                }
+            }
+        });
+    };
+    return { loadImportedModule, loadImportedModuleSync };
+}
+export const { loadImportedModule, loadImportedModuleSync } = createLoadImportedModule();
+//# sourceMappingURL=module.mjs.map

package/lib/node/module.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.mjs","sourceRoot":"","sources":["../../lib-src/node/module.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,GAC9D,MAAM,OAAO,CAAC;AAEf,MAAM,UAAU,wBAAwB,CAAC,WAAW,CAAC,KAAmB,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa;IAC1G,MAAM,YAAY,GAAG,CAAC,UAA+B,EAAE,MAA4C,EAAE,EAAE;QACrG,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,uBAAuB,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,KAAmB,EAAE,QAAgB,EAAE,UAA+B,EAAE,MAAc,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC9K,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1C,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAEpD,MAAM,kBAAkB,GAAwD,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE;QACxI,IAAI,QAAQ,YAAY,KAAK,IAAI,QAAQ,YAAY,SAAS,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;QAClG,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAqB,CAAC;QAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAE9B,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAChB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAU,CAAC,CAAC;YAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC/C,IAAI,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,CAAC;gBAC7B,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAChD,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC9D,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;gBACxB,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,uBAAuB,EAAE,SAAS,CAAC,CAAC,CAAC;YACnE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,MAAM,sBAAsB,GAAwD,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE;QAC5I,IAAI,QAAQ,YAAY,KAAK,IAAI,QAAQ,YAAY,SAAS,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;QAClG,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAqB,CAAC;QAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAE9B,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;YACV,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAU,CAAC,CAAC;YAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC/C,IAAI,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,CAAC;gBAC7B,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC9D,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;gBACxB,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;oBACrC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,uBAAuB,EAAE,SAAS,CAAC,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,GAAG,wBAAwB,EAAE,CAAC"}

package/lib-src/inspector/context.mts

@@ -0,0 +1,410 @@
+import type { Protocol } from 'devtools-protocol';
+import { getInspector } from './inspect.mts';
+import type { Inspector } from './index.mts';
+import {
+  evalQ,
+  EnsureCompletion, IsPromise, JSStringValue, ManagedRealm, NullValue, ObjectValue, SymbolValue, ThrowCompletion, UndefinedValue, Value,
+  type PromiseObject,
+  getHostDefinedErrorStack,
+  skipDebugger,
+  type ValueCompletion,
+  getCurrentStack,
+  isECMAScriptFunctionObject,
+  SymbolDescriptiveString,
+  type EnvironmentRecordWithThisBinding,
+  EnvironmentRecord,
+  DeclarativeEnvironmentRecord,
+  ObjectEnvironmentRecord,
+  FunctionEnvironmentRecord,
+  GlobalEnvironmentRecord,
+  ModuleEnvironmentRecord,
+  OrdinaryObjectCreate,
+  Descriptor,
+  isArgumentExoticObject,
+  Agent,
+  surroundingAgent,
+  IsAccessorDescriptor,
+  isIntegerIndex,
+  isBuiltinFunctionObject,
+  isArrayBufferObject,
+  DataBlock,
+  CallSite,
+} from '#self';
+
+interface InspectedRealmDescriptor {
+  readonly realm: ManagedRealm;
+  readonly descriptor: Protocol.Runtime.ExecutionContextDescription;
+  readonly agent: Agent;
+  detach(): void;
+}
+export class InspectorContext {
+  #io: Inspector;
+
+  constructor(io: Inspector) {
+    this.#io = io;
+  }
+
+  realms: (InspectedRealmDescriptor | undefined)[] = [];
+
+  attachRealm(realm: ManagedRealm, agent: Agent) {
+    const id = this.realms.length;
+    const descriptor: Protocol.Runtime.ExecutionContextDescription = {
+      id,
+      origin: 'vm://realm',
+      name: 'engine262',
+      uniqueId: id.toString(),
+    };
+    this.realms.push({
+      realm,
+      descriptor,
+      agent,
+      detach: () => {
+        realm.HostDefined.attachingInspector = oldInspector;
+      },
+    });
+    const oldInspector = realm.HostDefined.attachingInspector;
+    realm.HostDefined.attachingInspector = this.#io;
+    const oldPromiseRejectionTracker = realm.HostDefined.promiseRejectionTracker;
+    realm.HostDefined.promiseRejectionTracker = (promise, operation) => {
+      oldPromiseRejectionTracker?.(promise, operation);
+      if (operation === 'reject') {
+        this.#io.sendEvent['Runtime.exceptionThrown']({
+          timestamp: Date.now(),
+          exceptionDetails: this.createExceptionDetails(promise, true),
+        });
+      } else {
+        const id = this.#exceptionMap.get(promise);
+        if (id) {
+          this.#io.sendEvent['Runtime.exceptionRevoked']({
+            reason: 'Handler added to rejected promise',
+            exceptionId: id,
+          });
+        }
+      }
+    };
+    this.#io.sendEvent['Runtime.executionContextCreated']({ context: descriptor });
+  }
+
+  detachAgent(agent: Agent) {
+    for (const realm of this.realms) {
+      if (realm?.agent === agent) {
+        this.detachRealm(realm.realm);
+      }
+    }
+  }
+
+  detachRealm(realm: ManagedRealm) {
+    const index = this.realms.findIndex((c) => c?.realm === realm);
+    if (index === -1) {
+      return;
+    }
+    const { descriptor } = this.realms[index]!;
+    realm.HostDefined.attachingInspector = undefined;
+    this.realms[index] = undefined;
+    this.#io.sendEvent['Runtime.executionContextDestroyed']({ executionContextId: descriptor.id, executionContextUniqueId: descriptor.uniqueId });
+  }
+
+  getRealm(realm: ManagedRealm | string | number | undefined) {
+    if (realm === undefined) {
+      if (surroundingAgent.runningExecutionContext && surroundingAgent.currentRealmRecord instanceof ManagedRealm) {
+        realm = surroundingAgent.currentRealmRecord;
+      } else {
+        return undefined;
+      }
+    }
+    if (typeof realm === 'string') {
+      return this.realms.find((c) => c?.descriptor.uniqueId === realm);
+    } else if (typeof realm === 'number') {
+      return this.realms[realm];
+    }
+    return this.realms.find((c) => c?.realm === realm);
+  }
+
+  /** @deprecated in this case we are guessing the realm should be using, which may create bad result */
+  getAnyRealm() {
+    return this.realms.find(Boolean);
+  }
+
+  #idToObject = new Map<string, ObjectValue | SymbolValue>();
+
+  // id 0 is falsy, skip it
+  #idToArrayBufferBlock: (undefined | ArrayBuffer)[] = [undefined];
+
+  #objectToId = new Map<ObjectValue | SymbolValue, string>();
+
+  #objectCounter = 1;
+
+  #internObject(object: ObjectValue | SymbolValue, group = 'default') {
+    if (this.#objectToId.has(object)) {
+      return this.#objectToId.get(object)!;
+    }
+    const id = `${group}:${this.#objectCounter}`;
+    this.#objectCounter += 1;
+    this.#idToObject.set(id, object);
+    this.#objectToId.set(object, id);
+    return id;
+  }
+
+  releaseObject(id: string) {
+    const object = this.#idToObject.get(id);
+    if (object) {
+      this.#idToObject.delete(id);
+      this.#objectToId.delete(object);
+    }
+  }
+
+  releaseObjectGroup(group: string) {
+    for (const [id, object] of this.#idToObject.entries()) {
+      if (id.startsWith(group)) {
+        this.#idToObject.delete(id);
+        this.#objectToId.delete(object);
+      }
+    }
+  }
+
+  getObject(objectId: string) {
+    return this.#idToObject.get(objectId);
+  }
+
+  toRemoteObject(value: Value, options: { objectGroup?: string, generatePreview?: boolean }): Protocol.Runtime.RemoteObject {
+    return getInspector(value).toRemoteObject(value, (val) => this.#internObject(val, options.objectGroup), options.generatePreview);
+  }
+
+  getProperties({
+    objectId, accessorPropertiesOnly, generatePreview, nonIndexedPropertiesOnly, ownProperties,
+  }: Protocol.Runtime.GetPropertiesRequest): Protocol.Runtime.GetPropertiesResponse {
+    const object = this.getObject(objectId);
+    if (!(object instanceof ObjectValue)) {
+      return { result: [] };
+    }
+    const wrap = (v: Value) => this.toRemoteObject(v, { generatePreview });
+
+    const properties: Protocol.Runtime.PropertyDescriptor[] = [];
+    const internalProperties: Protocol.Runtime.InternalPropertyDescriptor[] = [];
+    const privateProperties: Protocol.Runtime.PrivatePropertyDescriptor[] = [];
+
+    object.PrivateElements.forEach((value) => {
+      privateProperties.push({
+        name: value.Key.Description.stringValue(),
+        value: value.Value ? wrap(value.Value) : undefined,
+        get: value.Get ? wrap(value.Get) : undefined,
+        set: value.Set ? wrap(value.Set) : undefined,
+      });
+    });
+
+    const value = evalQ((Q) => {
+      let p: NullValue | ObjectValue = object;
+      while (p instanceof ObjectValue) {
+        for (const key of Q(skipDebugger(p.OwnPropertyKeys()))) {
+          if (nonIndexedPropertiesOnly && isIntegerIndex(key)) {
+            continue;
+          }
+          const desc = Q(skipDebugger(p.GetOwnProperty(key)));
+          if (desc instanceof UndefinedValue) {
+            return;
+          }
+          if (accessorPropertiesOnly && !IsAccessorDescriptor(desc)) {
+            continue;
+          }
+          const descriptor: Protocol.Runtime.PropertyDescriptor = {
+            name: key instanceof JSStringValue
+              ? key.stringValue()
+              : SymbolDescriptiveString(key).stringValue(),
+            value: desc.Value && !('HostUninitializedBindingMarkerObject' in desc.Value) ? wrap(desc.Value) : undefined,
+            writable: desc.Writable === Value.true,
+            get: desc.Get ? wrap(desc.Get) : undefined,
+            set: desc.Set ? wrap(desc.Set) : undefined,
+            configurable: desc.Configurable === Value.true,
+            enumerable: desc.Enumerable === Value.true,
+            wasThrown: false,
+            isOwn: p === object,
+            symbol: key instanceof SymbolValue ? wrap(key) : undefined,
+          };
+          properties.push(descriptor);
+        }
+
+        if (ownProperties) {
+          break;
+        }
+        p = Q(skipDebugger(p.GetPrototypeOf()));
+      }
+    });
+    if (value.Type === 'throw') {
+      return {
+        result: [],
+        exceptionDetails: this.createExceptionDetails(value, false),
+      };
+    }
+
+    if (IsPromise(object) === Value.true) {
+      internalProperties.push({
+        name: '[[PromiseState]]',
+        value: {
+          type: 'string',
+          value: (object as PromiseObject).PromiseState,
+        },
+      });
+      internalProperties.push({
+        name: '[[PromiseResult]]',
+        value: wrap((object as PromiseObject).PromiseResult!),
+      });
+    }
+    if ('Prototype' in object) {
+      internalProperties.push({
+        name: '[[Prototype]]',
+        value: wrap(object.Prototype as Value),
+      });
+    }
+    if (isBuiltinFunctionObject(object) && object.nativeFunction.section) {
+      internalProperties.push({
+        name: '[[Section]]',
+        value: {
+          type: 'string',
+          value: object.nativeFunction.section,
+        },
+      });
+    }
+    if (isArrayBufferObject(object) && object.ArrayBufferData instanceof DataBlock) {
+      internalProperties.push({
+        name: '[[ArrayBufferByteLength]]',
+        value: {
+          type: 'number',
+          value: object.ArrayBufferByteLength,
+        },
+      });
+      this.#idToArrayBufferBlock.push(object.ArrayBufferData.buffer);
+      internalProperties.push({
+        name: '[[ArrayBufferData]]',
+        value: {
+          type: 'number',
+          value: this.#idToArrayBufferBlock.length - 1,
+        },
+      });
+    }
+
+    return { result: properties, internalProperties, privateProperties };
+  }
+
+  #exceptionMap = new WeakMap<Value, number>();
+
+  createExceptionDetails(completion: ThrowCompletion | Value, isPromise: boolean): Protocol.Runtime.ExceptionDetails {
+    const value = completion instanceof ThrowCompletion ? completion.Value : completion;
+    const stack = getHostDefinedErrorStack(value);
+    const frames = InspectorContext.callSiteToCallFrame(stack);
+    const exceptionId = this.#objectCounter;
+    this.#objectCounter += 1;
+    this.#exceptionMap.set(value, exceptionId);
+    return {
+      text: isPromise ? 'Uncaught (in promise)' : 'Uncaught',
+      stackTrace: stack ? { callFrames: frames } : undefined,
+      exception: getInspector(value).toRemoteObject(value, (val) => this.#internObject(val), false),
+      lineNumber: frames[0]?.lineNumber || 0,
+      columnNumber: frames[0]?.columnNumber || 0,
+      exceptionId,
+      scriptId: frames[0]?.scriptId,
+      url: frames[0]?.url,
+    };
+  }
+
+  static callSiteToCallFrame(callSite: readonly CallSite[] | undefined): Protocol.Runtime.CallFrame[] {
+    return callSite?.map((call) => call.toCallFrame()!).filter(Boolean) || [];
+  }
+
+  createEvaluationResult(completion: ValueCompletion): Protocol.Runtime.EvaluateResponse {
+    completion = EnsureCompletion(completion);
+    if (!(completion.Value instanceof Value)) {
+      throw new RangeError('Invalid completion value');
+    }
+    return {
+      exceptionDetails: completion instanceof ThrowCompletion ? this.createExceptionDetails(completion, false) : undefined,
+      result: this.toRemoteObject(completion.Value, {}),
+    };
+  }
+
+  getDebuggerCallFrame(): Protocol.Debugger.CallFrame[] {
+    const stacks = getCurrentStack(false);
+    const length = surroundingAgent.executionContextStack.length;
+    return stacks.map((stack, index): Protocol.Debugger.CallFrame => {
+      if (!stack.getScriptId()) {
+        return undefined!;
+      }
+      const scopeChain: Protocol.Debugger.Scope[] = [];
+      let env: EnvironmentRecord | NullValue = stack.context.LexicalEnvironment;
+      while (env instanceof EnvironmentRecord) {
+        const result = getDisplayObjectFromEnvironmentRecord(env);
+        if (result) {
+          scopeChain.push({ type: result.type, object: this.toRemoteObject(result.object, {}) });
+        }
+        env = env.OuterEnv;
+      }
+      return {
+        callFrameId: String(length - index - 1),
+        functionName: stack.getFunctionName() || '<anonymous>',
+        location: {
+          scriptId: stack.getScriptId()!,
+          lineNumber: (stack.lineNumber || 1) - 1,
+          columnNumber: (stack.columnNumber || 1) - 1,
+        },
+        this: this.toRemoteObject(HostGetThisEnvironment(stack.context.LexicalEnvironment), {}),
+        url: stack.getSpecifier() || '',
+        canBeRestarted: false,
+        functionLocation: isECMAScriptFunctionObject(stack.context.Function) ? {
+          lineNumber: (stack.context.Function.ECMAScriptCode?.location.start.line || 1) - 1,
+          columnNumber: (stack.context.Function.ECMAScriptCode?.location.start.column || 1) - 1,
+          scriptId: stack.getScriptId() || '',
+        } : undefined,
+        scopeChain,
+      };
+    }).filter(Boolean);
+  }
+
+  evaluateMode: 'script' | 'module' | 'console' = 'script';
+}
+
+function HostGetThisEnvironment(env: EnvironmentRecord | NullValue): Value {
+  while (!(env instanceof NullValue)) {
+    const exists = env.HasThisBinding();
+    if (exists === Value.true) {
+      const value = (env as EnvironmentRecordWithThisBinding).GetThisBinding();
+      if (value instanceof ThrowCompletion) {
+        return Value.undefined;
+      }
+      return value as Value;
+    }
+    const outer = env.OuterEnv;
+    env = outer;
+  }
+  throw new ReferenceError('No this environment found');
+}
+
+function getDisplayObjectFromEnvironmentRecord(record: EnvironmentRecord): undefined | { type: Protocol.Debugger.Scope['type'], object: ObjectValue } {
+  if (record instanceof DeclarativeEnvironmentRecord) {
+    const object = OrdinaryObjectCreate(Value.null, ['HostInspectorScopePreview']);
+    for (const [key, binding] of record.bindings) {
+      const value = binding.initialized ? binding.value! : OrdinaryObjectCreate(Value.null, ['HostUninitializedBindingMarkerObject']);
+      if (isArgumentExoticObject(value)) {
+        continue;
+      }
+      object.properties.set(key, Descriptor({
+        Enumerable: isArgumentExoticObject(value) ? Value.false : Value.true,
+        Value: value,
+        Writable: binding.mutable ? Value.true : Value.false,
+      }));
+    }
+    let type: Protocol.Debugger.Scope['type'] = 'block';
+    if (record instanceof FunctionEnvironmentRecord) {
+      type = 'local';
+    } else if (record instanceof ModuleEnvironmentRecord) {
+      type = 'module';
+    }
+    if (type !== 'local' && !object.properties.size) {
+      return undefined;
+    }
+    return { type, object };
+  } else if (record instanceof ObjectEnvironmentRecord) {
+    return { type: record.IsWithEnvironment === Value.true ? 'with' : 'global', object: record.BindingObject };
+  } else if (record instanceof GlobalEnvironmentRecord) {
+    return { type: 'global', object: record.GlobalThisValue };
+  }
+  throw new TypeError('Unknown environment record');
+}