@checkly/playwright-core 1.51.17-beta.2 → 1.54.2-beta.0

package/lib/server/trace/recorder/tracing.js

@@ -1,265 +1,270 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Tracing = void 0;
-exports.shouldCaptureSnapshot = shouldCaptureSnapshot;
-var _fs = _interopRequireDefault(require("fs"));
-var _os = _interopRequireDefault(require("os"));
-var _path = _interopRequireDefault(require("path"));
-var _snapshotter = require("./snapshotter");
-var _debug = require("../../../protocol/debug");
-var _assert = require("../../../utils/isomorphic/assert");
-var _time = require("../../../utils/isomorphic/time");
-var _eventsHelper = require("../../utils/eventsHelper");
-var _crypto = require("../../utils/crypto");
-var _artifact = require("../../artifact");
-var _browserContext = require("../../browserContext");
-var _dispatcher = require("../../dispatchers/dispatcher");
-var _errors = require("../../errors");
-var _fileUtils = require("../../utils/fileUtils");
-var _harTracer = require("../../har/harTracer");
-var _instrumentation = require("../../instrumentation");
-var _page = require("../../page");
-var _secretsFilter = require("../../../checkly/secretsFilter");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-const version = 7;
-const kScreencastOptions = {
-  width: 800,
-  height: 600,
-  quality: 90
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
 };
-class Tracing extends _instrumentation.SdkObject {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var tracing_exports = {};
+__export(tracing_exports, {
+  Tracing: () => Tracing,
+  shouldCaptureSnapshot: () => shouldCaptureSnapshot
+});
+module.exports = __toCommonJS(tracing_exports);
+var import_fs = __toESM(require("fs"));
+var import_os = __toESM(require("os"));
+var import_path = __toESM(require("path"));
+var import_snapshotter = require("./snapshotter");
+var import_protocolMetainfo = require("../../../utils/isomorphic/protocolMetainfo");
+var import_assert = require("../../../utils/isomorphic/assert");
+var import_time = require("../../../utils/isomorphic/time");
+var import_eventsHelper = require("../../utils/eventsHelper");
+var import_crypto = require("../../utils/crypto");
+var import_artifact = require("../../artifact");
+var import_browserContext = require("../../browserContext");
+var import_dispatcher = require("../../dispatchers/dispatcher");
+var import_errors = require("../../errors");
+var import_fileUtils = require("../../utils/fileUtils");
+var import_harTracer = require("../../har/harTracer");
+var import_instrumentation = require("../../instrumentation");
+var import_page = require("../../page");
+var import_secretsFilter = require("../../../checkly/secretsFilter");
+var import_progress = require("../../progress");
+const version = 8;
+const kScreencastOptions = { width: 800, height: 600, quality: 90 };
+class Tracing extends import_instrumentation.SdkObject {
   constructor(context, tracesDir) {
-    super(context, 'tracing');
-    this._fs = new _fileUtils.SerializedFS();
-    this._snapshotter = void 0;
-    this._harTracer = void 0;
+    super(context, "tracing");
+    this._fs = new import_fileUtils.SerializedFS();
     this._screencastListeners = [];
     this._eventListeners = [];
-    this._context = void 0;
-    // Note: state should only be touched inside API methods, but not inside trace operations.
-    this._state = void 0;
     this._isStopping = false;
-    this._precreatedTracesDir = void 0;
-    this._tracesTmpDir = void 0;
-    this._allResources = new Set();
-    this._contextCreatedEvent = void 0;
-    this._pendingHarEntries = new Set();
-    this._secretsFilter = void 0;
+    this._allResources = /* @__PURE__ */ new Set();
+    this._pendingHarEntries = /* @__PURE__ */ new Set();
     this._context = context;
     this._precreatedTracesDir = tracesDir;
-    this._secretsFilter = (0, _secretsFilter.secretsFilter)();
-    this._harTracer = new _harTracer.HarTracer(context, null, this, {
-      content: 'attach',
+    this._secretsFilter = (0, import_secretsFilter.secretsFilter)();
+    this._harTracer = new import_harTracer.HarTracer(context, null, this, {
+      content: "attach",
       includeTraceInfo: true,
       recordRequestOverrides: false,
       waitForContentOnStop: false
     });
-    const testIdAttributeName = 'selectors' in context ? context.selectors().testIdAttributeName() : undefined;
+    const testIdAttributeName = "selectors" in context ? context.selectors().testIdAttributeName() : void 0;
     this._contextCreatedEvent = {
       version,
-      type: 'context-options',
-      origin: 'library',
-      browserName: '',
+      type: "context-options",
+      origin: "library",
+      browserName: "",
       options: {},
       platform: process.platform,
       wallTime: 0,
       monotonicTime: 0,
-      sdkLanguage: context.attribution.playwright.options.sdkLanguage,
+      sdkLanguage: this._sdkLanguage(),
       testIdAttributeName,
       contextId: context.guid
     };
-    if (context instanceof _browserContext.BrowserContext) {
-      this._snapshotter = new _snapshotter.Snapshotter(context, this);
-      (0, _assert.assert)(tracesDir, 'tracesDir must be specified for BrowserContext');
+    if (context instanceof import_browserContext.BrowserContext) {
+      this._snapshotter = new import_snapshotter.Snapshotter(context, this);
+      (0, import_assert.assert)(tracesDir, "tracesDir must be specified for BrowserContext");
       this._contextCreatedEvent.browserName = context._browser.options.name;
       this._contextCreatedEvent.channel = context._browser.options.channel;
       this._contextCreatedEvent.options = context._options;
     }
   }
-  async resetForReuse() {
-    var _this$_snapshotter;
-    // Discard previous chunk if any and ignore any errors there.
-    await this.stopChunk({
-      mode: 'discard'
-    }).catch(() => {});
-    await this.stop();
-    (_this$_snapshotter = this._snapshotter) === null || _this$_snapshotter === void 0 || _this$_snapshotter.resetForReuse();
-  }
-  async start(options) {
-    if (this._isStopping) throw new Error('Cannot start tracing while stopping');
-    if (this._state) throw new Error('Tracing has been already started');
-
-    // Re-write for testing.
-    this._contextCreatedEvent.sdkLanguage = this._context.attribution.playwright.options.sdkLanguage;
-
-    // TODO: passing the same name for two contexts makes them write into a single file
-    // and conflict.
-    const traceName = options.name || (0, _crypto.createGuid)();
+  _sdkLanguage() {
+    return this._context instanceof import_browserContext.BrowserContext ? this._context._browser.sdkLanguage() : this._context.attribution.playwright.options.sdkLanguage;
+  }
+  async resetForReuse(progress) {
+    await this.stopChunk(progress, { mode: "discard" }).catch(() => {
+    });
+    await this.stop(progress);
+    if (this._snapshotter)
+      await progress.race(this._snapshotter.resetForReuse());
+  }
+  start(options) {
+    if (this._isStopping)
+      throw new Error("Cannot start tracing while stopping");
+    if (this._state)
+      throw new Error("Tracing has been already started");
+    this._contextCreatedEvent.sdkLanguage = this._sdkLanguage();
+    const traceName = options.name || (0, import_crypto.createGuid)();
     const tracesDir = this._createTracesDirIfNeeded();
-
-    // Init the state synchronously.
     this._state = {
       options,
       traceName,
       tracesDir,
-      traceFile: _path.default.join(tracesDir, traceName + '.trace'),
-      networkFile: _path.default.join(tracesDir, traceName + '.network'),
-      resourcesDir: _path.default.join(tracesDir, 'resources'),
+      traceFile: import_path.default.join(tracesDir, traceName + ".trace"),
+      networkFile: import_path.default.join(tracesDir, traceName + ".network"),
+      resourcesDir: import_path.default.join(tracesDir, "resources"),
       chunkOrdinal: 0,
-      traceSha1s: new Set(),
-      networkSha1s: new Set(),
+      traceSha1s: /* @__PURE__ */ new Set(),
+      networkSha1s: /* @__PURE__ */ new Set(),
       recording: false,
-      callIds: new Set(),
+      callIds: /* @__PURE__ */ new Set(),
       groupStack: []
     };
     this._fs.mkdir(this._state.resourcesDir);
-    this._fs.writeFile(this._state.networkFile, '');
-    // Tracing is 10x bigger if we include scripts in every trace.
-    if (options.snapshots) this._harTracer.start({
-      omitScripts: !options.live
-    });
-  }
-  async startChunk(options = {}) {
-    var _this$_snapshotter2;
-    if (this._state && this._state.recording) await this.stopChunk({
-      mode: 'discard'
-    });
-    if (!this._state) throw new Error('Must start tracing before starting a new chunk');
-    if (this._isStopping) throw new Error('Cannot start a trace chunk while stopping');
+    this._fs.writeFile(this._state.networkFile, "");
+    if (options.snapshots)
+      this._harTracer.start({ omitScripts: !options.live });
+  }
+  async startChunk(progress, options = {}) {
+    if (this._state && this._state.recording)
+      await this.stopChunk(progress, { mode: "discard" });
+    if (!this._state)
+      throw new Error("Must start tracing before starting a new chunk");
+    if (this._isStopping)
+      throw new Error("Cannot start a trace chunk while stopping");
     this._state.recording = true;
     this._state.callIds.clear();
-
-    // - Browser context network trace is shared across chunks as it contains resources
-    // used to serve page snapshots, so make a copy with the new name.
-    // - APIRequestContext network traces are chunk-specific, always start from scratch.
-    const preserveNetworkResources = this._context instanceof _browserContext.BrowserContext;
-    if (options.name && options.name !== this._state.traceName) this._changeTraceName(this._state, options.name, preserveNetworkResources);else this._allocateNewTraceFile(this._state);
-    if (!preserveNetworkResources) this._fs.writeFile(this._state.networkFile, '');
-    this._fs.mkdir(_path.default.dirname(this._state.traceFile));
+    const preserveNetworkResources = this._context instanceof import_browserContext.BrowserContext;
+    if (options.name && options.name !== this._state.traceName)
+      this._changeTraceName(this._state, options.name, preserveNetworkResources);
+    else
+      this._allocateNewTraceFile(this._state);
+    if (!preserveNetworkResources)
+      this._fs.writeFile(this._state.networkFile, "");
+    this._fs.mkdir(import_path.default.dirname(this._state.traceFile));
     const event = {
       ...this._contextCreatedEvent,
       title: options.title,
       wallTime: Date.now(),
-      monotonicTime: (0, _time.monotonicTime)()
+      monotonicTime: (0, import_time.monotonicTime)()
     };
     this._appendTraceEvent(event);
     this._context.instrumentation.addListener(this, this._context);
-    this._eventListeners.push(_eventsHelper.eventsHelper.addEventListener(this._context, _browserContext.BrowserContext.Events.Console, this._onConsoleMessage.bind(this)), _eventsHelper.eventsHelper.addEventListener(this._context, _browserContext.BrowserContext.Events.PageError, this._onPageError.bind(this)));
-    if (this._state.options.screenshots) this._startScreencast();
-    if (this._state.options.snapshots) await ((_this$_snapshotter2 = this._snapshotter) === null || _this$_snapshotter2 === void 0 ? void 0 : _this$_snapshotter2.start());
-    return {
-      traceName: this._state.traceName
-    };
+    this._eventListeners.push(
+      import_eventsHelper.eventsHelper.addEventListener(this._context, import_browserContext.BrowserContext.Events.Console, this._onConsoleMessage.bind(this)),
+      import_eventsHelper.eventsHelper.addEventListener(this._context, import_browserContext.BrowserContext.Events.PageError, this._onPageError.bind(this))
+    );
+    if (this._state.options.screenshots)
+      this._startScreencast();
+    if (this._state.options.snapshots)
+      await this._snapshotter?.start();
+    return { traceName: this._state.traceName };
   }
   _currentGroupId() {
-    var _this$_state;
-    return (_this$_state = this._state) !== null && _this$_state !== void 0 && _this$_state.groupStack.length ? this._state.groupStack[this._state.groupStack.length - 1] : undefined;
+    return this._state?.groupStack.length ? this._state.groupStack[this._state.groupStack.length - 1] : void 0;
   }
-  async group(name, location, metadata) {
-    var _ref;
-    if (!this._state) return;
+  group(name, location, metadata) {
+    if (!this._state)
+      return;
     const stackFrames = [];
-    const {
-      file,
-      line,
-      column
-    } = (_ref = location !== null && location !== void 0 ? location : metadata.location) !== null && _ref !== void 0 ? _ref : {};
+    const { file, line, column } = location ?? metadata.location ?? {};
     if (file) {
       stackFrames.push({
         file,
-        line: line !== null && line !== void 0 ? line : 0,
-        column: column !== null && column !== void 0 ? column : 0
+        line: line ?? 0,
+        column: column ?? 0
       });
     }
     const event = {
-      type: 'before',
+      type: "before",
       callId: metadata.id,
       startTime: metadata.startTime,
-      apiName: name,
-      class: 'Tracing',
-      method: 'tracingGroup',
+      title: name,
+      class: "Tracing",
+      method: "tracingGroup",
       params: {},
       stepId: metadata.stepId,
       stack: stackFrames
     };
-    if (this._currentGroupId()) event.parentId = this._currentGroupId();
+    if (this._currentGroupId())
+      event.parentId = this._currentGroupId();
     this._state.groupStack.push(event.callId);
     this._appendTraceEvent(event);
   }
   groupEnd() {
-    if (!this._state) return;
+    if (!this._state)
+      return;
     const callId = this._state.groupStack.pop();
-    if (!callId) return;
+    if (!callId)
+      return;
     const event = {
-      type: 'after',
+      type: "after",
       callId,
-      endTime: (0, _time.monotonicTime)()
+      endTime: (0, import_time.monotonicTime)()
     };
     this._appendTraceEvent(event);
   }
   _startScreencast() {
-    if (!(this._context instanceof _browserContext.BrowserContext)) return;
-    for (const page of this._context.pages()) this._startScreencastInPage(page);
-    this._screencastListeners.push(_eventsHelper.eventsHelper.addEventListener(this._context, _browserContext.BrowserContext.Events.Page, this._startScreencastInPage.bind(this)));
+    if (!(this._context instanceof import_browserContext.BrowserContext))
+      return;
+    for (const page of this._context.pages())
+      this._startScreencastInPage(page);
+    this._screencastListeners.push(
+      import_eventsHelper.eventsHelper.addEventListener(this._context, import_browserContext.BrowserContext.Events.Page, this._startScreencastInPage.bind(this))
+    );
   }
   _stopScreencast() {
-    _eventsHelper.eventsHelper.removeEventListeners(this._screencastListeners);
-    if (!(this._context instanceof _browserContext.BrowserContext)) return;
-    for (const page of this._context.pages()) page.setScreencastOptions(null);
+    import_eventsHelper.eventsHelper.removeEventListeners(this._screencastListeners);
+    if (!(this._context instanceof import_browserContext.BrowserContext))
+      return;
+    for (const page of this._context.pages())
+      page.setScreencastOptions(null);
   }
   _allocateNewTraceFile(state) {
     const suffix = state.chunkOrdinal ? `-chunk${state.chunkOrdinal}` : ``;
     state.chunkOrdinal++;
-    state.traceFile = _path.default.join(state.tracesDir, `${state.traceName}${suffix}.trace`);
+    state.traceFile = import_path.default.join(state.tracesDir, `${state.traceName}${suffix}.trace`);
   }
   _changeTraceName(state, name, preserveNetworkResources) {
     state.traceName = name;
-    state.chunkOrdinal = 0; // Reset ordinal for the new name.
+    state.chunkOrdinal = 0;
     this._allocateNewTraceFile(state);
-    const newNetworkFile = _path.default.join(state.tracesDir, name + '.network');
-    if (preserveNetworkResources) this._fs.copyFile(state.networkFile, newNetworkFile);
+    const newNetworkFile = import_path.default.join(state.tracesDir, name + ".network");
+    if (preserveNetworkResources)
+      this._fs.copyFile(state.networkFile, newNetworkFile);
     state.networkFile = newNetworkFile;
   }
-  async stop() {
-    if (!this._state) return;
-    if (this._isStopping) throw new Error(`Tracing is already stopping`);
-    if (this._state.recording) throw new Error(`Must stop trace file before stopping tracing`);
+  async stop(progress) {
+    if (!this._state)
+      return;
+    if (this._isStopping)
+      throw new Error(`Tracing is already stopping`);
+    if (this._state.recording)
+      throw new Error(`Must stop trace file before stopping tracing`);
     this._closeAllGroups();
     this._harTracer.stop();
     this.flushHarEntries();
-    await this._fs.syncAndGetError();
-    this._state = undefined;
+    await progress.race(this._fs.syncAndGetError()).finally(() => {
+      this._state = void 0;
+    });
   }
   async deleteTmpTracesDir() {
-    if (this._tracesTmpDir) await (0, _fileUtils.removeFolders)([this._tracesTmpDir]);
+    if (this._tracesTmpDir)
+      await (0, import_fileUtils.removeFolders)([this._tracesTmpDir]);
   }
   _createTracesDirIfNeeded() {
-    if (this._precreatedTracesDir) return this._precreatedTracesDir;
-    this._tracesTmpDir = _fs.default.mkdtempSync(_path.default.join(_os.default.tmpdir(), 'playwright-tracing-'));
+    if (this._precreatedTracesDir)
+      return this._precreatedTracesDir;
+    this._tracesTmpDir = import_fs.default.mkdtempSync(import_path.default.join(import_os.default.tmpdir(), "playwright-tracing-"));
     return this._tracesTmpDir;
   }
   abort() {
-    var _this$_snapshotter3;
-    (_this$_snapshotter3 = this._snapshotter) === null || _this$_snapshotter3 === void 0 || _this$_snapshotter3.dispose();
+    this._snapshotter?.dispose();
     this._harTracer.stop();
   }
   async flush() {
@@ -267,120 +272,108 @@ class Tracing extends _instrumentation.SdkObject {
     await this._fs.syncAndGetError();
   }
   _closeAllGroups() {
-    while (this._currentGroupId()) this.groupEnd();
+    while (this._currentGroupId())
+      this.groupEnd();
   }
-  async stopChunk(params) {
-    var _this$_snapshotter4;
-    if (this._isStopping) throw new Error(`Tracing is already stopping`);
+  async stopChunk(progress, params) {
+    if (this._isStopping)
+      throw new Error(`Tracing is already stopping`);
     this._isStopping = true;
     if (!this._state || !this._state.recording) {
       this._isStopping = false;
-      if (params.mode !== 'discard') throw new Error(`Must start tracing before stopping`);
+      if (params.mode !== "discard")
+        throw new Error(`Must start tracing before stopping`);
       return {};
     }
     this._closeAllGroups();
     this._context.instrumentation.removeListener(this);
-    _eventsHelper.eventsHelper.removeEventListeners(this._eventListeners);
-    if (this._state.options.screenshots) this._stopScreencast();
-    if (this._state.options.snapshots) await ((_this$_snapshotter4 = this._snapshotter) === null || _this$_snapshotter4 === void 0 ? void 0 : _this$_snapshotter4.stop());
+    import_eventsHelper.eventsHelper.removeEventListeners(this._eventListeners);
+    if (this._state.options.screenshots)
+      this._stopScreencast();
+    if (this._state.options.snapshots)
+      this._snapshotter?.stop();
     this.flushHarEntries();
-
-    // Network file survives across chunks, make a snapshot before returning the resulting entries.
-    // We should pick a name starting with "traceName" and ending with .network.
-    // Something like <traceName>someSuffixHere.network.
-    // However, this name must not clash with any other "traceName".network in the same tracesDir.
-    // We can use <traceName>-<guid>.network, but "-pwnetcopy-0" suffix is more readable
-    // and makes it easier to debug future issues.
-    const newNetworkFile = _path.default.join(this._state.tracesDir, this._state.traceName + `-pwnetcopy-${this._state.chunkOrdinal}.network`);
+    const newNetworkFile = import_path.default.join(this._state.tracesDir, this._state.traceName + `-pwnetcopy-${this._state.chunkOrdinal}.network`);
     const entries = [];
-    entries.push({
-      name: 'trace.trace',
-      value: this._state.traceFile
-    });
-    entries.push({
-      name: 'trace.network',
-      value: newNetworkFile
-    });
-    for (const sha1 of new Set([...this._state.traceSha1s, ...this._state.networkSha1s])) entries.push({
-      name: _path.default.join('resources', sha1),
-      value: _path.default.join(this._state.resourcesDir, sha1)
-    });
-
-    // Only reset trace sha1s, network resources are preserved between chunks.
-    this._state.traceSha1s = new Set();
-    if (params.mode === 'discard') {
+    entries.push({ name: "trace.trace", value: this._state.traceFile });
+    entries.push({ name: "trace.network", value: newNetworkFile });
+    for (const sha1 of /* @__PURE__ */ new Set([...this._state.traceSha1s, ...this._state.networkSha1s]))
+      entries.push({ name: import_path.default.join("resources", sha1), value: import_path.default.join(this._state.resourcesDir, sha1) });
+    this._state.traceSha1s = /* @__PURE__ */ new Set();
+    if (params.mode === "discard") {
       this._isStopping = false;
       this._state.recording = false;
       return {};
     }
     this._fs.copyFile(this._state.networkFile, newNetworkFile);
-    const zipFileName = this._state.traceFile + '.zip';
-    if (params.mode === 'archive') this._fs.zip(entries, zipFileName);
-
-    // Make sure all file operations complete.
-    const error = await this._fs.syncAndGetError();
+    const zipFileName = this._state.traceFile + ".zip";
+    if (params.mode === "archive")
+      this._fs.zip(entries, zipFileName);
+    const error = await progress.race(this._fs.syncAndGetError()).catch((e) => e);
     this._isStopping = false;
-    if (this._state) this._state.recording = false;
-
-    // IMPORTANT: no awaits after this point, to make sure recording state is correct.
-
+    if (this._state)
+      this._state.recording = false;
     if (error) {
-      // This check is here because closing the browser removes the tracesDir and tracing
-      // cannot access removed files. Clients are ready for the missing artifact.
-      if (this._context instanceof _browserContext.BrowserContext && !this._context._browser.isConnected()) return {};
+      if (!(0, import_progress.isAbortError)(error) && this._context instanceof import_browserContext.BrowserContext && !this._context._browser.isConnected())
+        return {};
       throw error;
     }
-    if (params.mode === 'entries') return {
-      entries
-    };
-    const artifact = new _artifact.Artifact(this._context, zipFileName);
+    if (params.mode === "entries")
+      return { entries };
+    const artifact = new import_artifact.Artifact(this._context, zipFileName);
     artifact.reportFinished();
-    return {
-      artifact
-    };
+    return { artifact };
   }
   async _captureSnapshot(snapshotName, sdkObject, metadata) {
-    if (!this._snapshotter) return;
-    if (!sdkObject.attribution.page) return;
-    if (!this._snapshotter.started()) return;
-    if (!shouldCaptureSnapshot(metadata)) return;
-    await this._snapshotter.captureSnapshot(sdkObject.attribution.page, metadata.id, snapshotName).catch(() => {});
+    if (!this._snapshotter)
+      return;
+    if (!sdkObject.attribution.page)
+      return;
+    if (!this._snapshotter.started())
+      return;
+    if (!shouldCaptureSnapshot(metadata))
+      return;
+    await this._snapshotter.captureSnapshot(sdkObject.attribution.page, metadata.id, snapshotName).catch(() => {
+    });
   }
   onBeforeCall(sdkObject, metadata) {
-    var _sdkObject$attributio, _this$_state2;
-    // IMPORTANT: no awaits before this._appendTraceEvent in this method.
     const event = createBeforeActionTraceEvent(metadata, this._currentGroupId());
-    if (!event) return Promise.resolve();
-    (_sdkObject$attributio = sdkObject.attribution.page) === null || _sdkObject$attributio === void 0 || _sdkObject$attributio.temporarilyDisableTracingScreencastThrottling();
+    if (!event)
+      return Promise.resolve();
+    sdkObject.attribution.page?.temporarilyDisableTracingScreencastThrottling();
     event.beforeSnapshot = `before@${metadata.id}`;
-    (_this$_state2 = this._state) === null || _this$_state2 === void 0 || _this$_state2.callIds.add(metadata.id);
+    this._state?.callIds.add(metadata.id);
     this._appendTraceEvent(event);
     return this._captureSnapshot(event.beforeSnapshot, sdkObject, metadata);
   }
   onBeforeInputAction(sdkObject, metadata) {
-    var _this$_state3, _sdkObject$attributio2;
-    if (!((_this$_state3 = this._state) !== null && _this$_state3 !== void 0 && _this$_state3.callIds.has(metadata.id))) return Promise.resolve();
-    // IMPORTANT: no awaits before this._appendTraceEvent in this method.
+    if (!this._state?.callIds.has(metadata.id))
+      return Promise.resolve();
     const event = createInputActionTraceEvent(metadata);
-    if (!event) return Promise.resolve();
-    (_sdkObject$attributio2 = sdkObject.attribution.page) === null || _sdkObject$attributio2 === void 0 || _sdkObject$attributio2.temporarilyDisableTracingScreencastThrottling();
+    if (!event)
+      return Promise.resolve();
+    sdkObject.attribution.page?.temporarilyDisableTracingScreencastThrottling();
     event.inputSnapshot = `input@${metadata.id}`;
     this._appendTraceEvent(event);
     return this._captureSnapshot(event.inputSnapshot, sdkObject, metadata);
   }
   onCallLog(sdkObject, metadata, logName, message) {
-    if (metadata.isServerSide || metadata.internal) return;
-    if (logName !== 'api') return;
+    if (metadata.isServerSide || metadata.internal)
+      return;
+    if (logName !== "api")
+      return;
     const event = createActionLogTraceEvent(metadata, message);
-    if (event) this._appendTraceEvent(event);
+    if (event)
+      this._appendTraceEvent(event);
   }
   async onAfterCall(sdkObject, metadata) {
-    var _this$_state4, _this$_state5, _sdkObject$attributio3;
-    if (!((_this$_state4 = this._state) !== null && _this$_state4 !== void 0 && _this$_state4.callIds.has(metadata.id))) return;
-    (_this$_state5 = this._state) === null || _this$_state5 === void 0 || _this$_state5.callIds.delete(metadata.id);
+    if (!this._state?.callIds.has(metadata.id))
+      return;
+    this._state?.callIds.delete(metadata.id);
     const event = createAfterActionTraceEvent(metadata);
-    if (!event) return;
-    (_sdkObject$attributio3 = sdkObject.attribution.page) === null || _sdkObject$attributio3 === void 0 || _sdkObject$attributio3.temporarilyDisableTracingScreencastThrottling();
+    if (!event)
+      return;
+    sdkObject.attribution.page?.temporarilyDisableTracingScreencastThrottling();
     event.afterSnapshot = `after@${metadata.id}`;
     this._appendTraceEvent(event);
     return this._captureSnapshot(event.afterSnapshot, sdkObject, metadata);
@@ -390,25 +383,30 @@ class Tracing extends _instrumentation.SdkObject {
   }
   onEntryFinished(entry) {
     this._pendingHarEntries.delete(entry);
-    const event = {
-      type: 'resource-snapshot',
-      snapshot: entry
-    };
+    const event = { type: "resource-snapshot", snapshot: entry };
     const visited = visitTraceEvent(event, this._state.networkSha1s, this._secretsFilter);
-    this._fs.appendFile(this._state.networkFile, JSON.stringify(visited) + '\n', true /* flush */);
+    this._fs.appendFile(
+      this._state.networkFile,
+      JSON.stringify(visited) + "\n",
+      true
+      /* flush */
+    );
   }
   flushHarEntries() {
     const harLines = [];
     for (const entry of this._pendingHarEntries) {
-      const event = {
-        type: 'resource-snapshot',
-        snapshot: entry
-      };
+      const event = { type: "resource-snapshot", snapshot: entry };
       const visited = visitTraceEvent(event, this._state.networkSha1s, this._secretsFilter);
       harLines.push(JSON.stringify(visited));
     }
     this._pendingHarEntries.clear();
-    if (harLines.length) this._fs.appendFile(this._state.networkFile, harLines.join('\n') + '\n', true /* flush */);
+    if (harLines.length)
+      this._fs.appendFile(
+        this._state.networkFile,
+        harLines.join("\n") + "\n",
+        true
+        /* flush */
+      );
   }
   onContentBlob(sha1, buffer) {
     this._appendResource(sha1, buffer);
@@ -417,91 +415,67 @@ class Tracing extends _instrumentation.SdkObject {
     this._appendResource(blob.sha1, blob.buffer);
   }
   onFrameSnapshot(snapshot) {
-    this._appendTraceEvent({
-      type: 'frame-snapshot',
-      snapshot
-    });
+    this._appendTraceEvent({ type: "frame-snapshot", snapshot });
   }
   _onConsoleMessage(message) {
-    var _message$page;
     const event = {
-      type: 'console',
+      type: "console",
       messageType: message.type(),
       text: message.text(),
-      args: message.args().map(a => ({
-        preview: a.toString(),
-        value: a.rawValue()
-      })),
+      args: message.args().map((a) => ({ preview: a.toString(), value: a.rawValue() })),
       location: message.location(),
-      time: (0, _time.monotonicTime)(),
-      pageId: (_message$page = message.page()) === null || _message$page === void 0 ? void 0 : _message$page.guid
+      time: (0, import_time.monotonicTime)(),
+      pageId: message.page()?.guid
     };
     this._appendTraceEvent(event);
   }
   onDialog(dialog) {
     const event = {
-      type: 'event',
-      time: (0, _time.monotonicTime)(),
-      class: 'BrowserContext',
-      method: 'dialog',
-      params: {
-        pageId: dialog.page().guid,
-        type: dialog.type(),
-        message: dialog.message(),
-        defaultValue: dialog.defaultValue()
-      }
+      type: "event",
+      time: (0, import_time.monotonicTime)(),
+      class: "BrowserContext",
+      method: "dialog",
+      params: { pageId: dialog.page().guid, type: dialog.type(), message: dialog.message(), defaultValue: dialog.defaultValue() }
     };
     this._appendTraceEvent(event);
   }
   onDownload(page, download) {
     const event = {
-      type: 'event',
-      time: (0, _time.monotonicTime)(),
-      class: 'BrowserContext',
-      method: 'download',
-      params: {
-        pageId: page.guid,
-        url: download.url,
-        suggestedFilename: download.suggestedFilename()
-      }
+      type: "event",
+      time: (0, import_time.monotonicTime)(),
+      class: "BrowserContext",
+      method: "download",
+      params: { pageId: page.guid, url: download.url, suggestedFilename: download.suggestedFilename() }
     };
     this._appendTraceEvent(event);
   }
   onPageOpen(page) {
-    var _page$opener;
     const event = {
-      type: 'event',
-      time: (0, _time.monotonicTime)(),
-      class: 'BrowserContext',
-      method: 'page',
-      params: {
-        pageId: page.guid,
-        openerPageId: (_page$opener = page.opener()) === null || _page$opener === void 0 ? void 0 : _page$opener.guid
-      }
+      type: "event",
+      time: (0, import_time.monotonicTime)(),
+      class: "BrowserContext",
+      method: "page",
+      params: { pageId: page.guid, openerPageId: page.opener()?.guid }
     };
     this._appendTraceEvent(event);
   }
   onPageClose(page) {
     const event = {
-      type: 'event',
-      time: (0, _time.monotonicTime)(),
-      class: 'BrowserContext',
-      method: 'pageClosed',
-      params: {
-        pageId: page.guid
-      }
+      type: "event",
+      time: (0, import_time.monotonicTime)(),
+      class: "BrowserContext",
+      method: "pageClosed",
+      params: { pageId: page.guid }
     };
     this._appendTraceEvent(event);
   }
   _onPageError(error, page) {
     const event = {
-      type: 'event',
-      time: (0, _time.monotonicTime)(),
-      class: 'BrowserContext',
-      method: 'pageError',
-      params: {
-        error: (0, _errors.serializeError)(error)
-      },
+      type: "event",
+      time: (0, import_time.monotonicTime)(),
+      class: "BrowserContext",
+      method: "pageError",
+      params: { error: (0, import_errors.serializeError)(error) },
       pageId: page.guid
     };
     this._appendTraceEvent(event);
@@ -509,60 +483,68 @@ class Tracing extends _instrumentation.SdkObject {
   _startScreencastInPage(page) {
     page.setScreencastOptions(kScreencastOptions);
     const prefix = page.guid;
-    this._screencastListeners.push(_eventsHelper.eventsHelper.addEventListener(page, _page.Page.Events.ScreencastFrame, params => {
-      const suffix = params.timestamp || Date.now();
-      const sha1 = `${prefix}-${suffix}.jpeg`;
-      const event = {
-        type: 'screencast-frame',
-        pageId: page.guid,
-        sha1,
-        width: params.width,
-        height: params.height,
-        timestamp: (0, _time.monotonicTime)(),
-        frameSwapWallTime: params.frameSwapWallTime
-      };
-      // Make sure to write the screencast frame before adding a reference to it.
-      this._appendResource(sha1, params.buffer);
-      this._appendTraceEvent(event);
-    }));
+    this._screencastListeners.push(
+      import_eventsHelper.eventsHelper.addEventListener(page, import_page.Page.Events.ScreencastFrame, (params) => {
+        const suffix = params.timestamp || Date.now();
+        const sha1 = `${prefix}-${suffix}.jpeg`;
+        const event = {
+          type: "screencast-frame",
+          pageId: page.guid,
+          sha1,
+          width: params.width,
+          height: params.height,
+          timestamp: (0, import_time.monotonicTime)(),
+          frameSwapWallTime: params.frameSwapWallTime
+        };
+        this._appendResource(sha1, params.buffer);
+        this._appendTraceEvent(event);
+      })
+    );
   }
   _appendTraceEvent(event) {
     const visited = visitTraceEvent(event, this._state.traceSha1s, this._secretsFilter);
-    // Do not flush (console) events, they are too noisy, unless we are in ui mode (live).
-    const flush = this._state.options.live || event.type !== 'event' && event.type !== 'console' && event.type !== 'log';
-    this._fs.appendFile(this._state.traceFile, JSON.stringify(visited) + '\n', flush);
+    const flush = this._state.options.live || event.type !== "event" && event.type !== "console" && event.type !== "log";
+    this._fs.appendFile(this._state.traceFile, JSON.stringify(visited) + "\n", flush);
   }
   _appendResource(sha1, buffer) {
-    if (this._allResources.has(sha1)) return;
+    if (this._allResources.has(sha1))
+      return;
     this._allResources.add(sha1);
-    const resourcePath = _path.default.join(this._state.resourcesDir, sha1);
-    this._fs.writeFile(resourcePath, buffer, true /* skipIfExists */);
+    const resourcePath = import_path.default.join(this._state.resourcesDir, sha1);
+    this._fs.writeFile(
+      resourcePath,
+      buffer,
+      true
+      /* skipIfExists */
+    );
   }
 }
-exports.Tracing = Tracing;
-function visitTraceEvent(object, sha1s, secretsFilter) {
-  if (Array.isArray(object)) return object.map(o => {
-    if (typeof o === 'string' && new Date(o).toString() === 'Invalid Date') {
-      return secretsFilter(o);
-    }
-    return visitTraceEvent(o, sha1s, secretsFilter);
-  });
-  if (object instanceof _dispatcher.Dispatcher) return `<${object._type}>`;
-  if (object instanceof Buffer) return `<Buffer>`;
-  if (object instanceof Date) return object;
-  if (typeof object === 'object') {
+function visitTraceEvent(object, sha1s, secretsFilter2) {
+  if (Array.isArray(object)) {
+    return object.map((o) => {
+      if (typeof o === "string" && new Date(o).toString() === "Invalid Date")
+        return secretsFilter2(o);
+      return visitTraceEvent(o, sha1s, secretsFilter2);
+    });
+  }
+  if (object instanceof import_dispatcher.Dispatcher)
+    return `<${object._type}>`;
+  if (object instanceof Buffer)
+    return `<Buffer>`;
+  if (object instanceof Date)
+    return object;
+  if (typeof object === "object") {
     const result = {};
     for (const key in object) {
       const value = object[key];
-      if (key === 'sha1' || key === '_sha1' || key.endsWith('Sha1')) {
-        if (value) sha1s.add(value);
+      if (key === "sha1" || key === "_sha1" || key.endsWith("Sha1")) {
+        if (value)
+          sha1s.add(value);
       }
-      if (typeof value === 'string') {
-        // Some values like numbers or certain strings shouldn't be scrubbed,
-        // Otherwise parts of the trace will be unreadable.
-        result[key] = key.endsWith('Sha1') || ['pageref', '_sha1', 'downloadsPath', 'tracesDir', 'pageId', 'sha1'].includes(key) ? value : secretsFilter(value);
+      if (typeof value === "string") {
+        result[key] = key.endsWith("Sha1") || ["pageref", "_sha1", "downloadsPath", "tracesDir", "pageId", "sha1"].includes(key) ? value : secretsFilter2(value);
       } else {
-        result[key] = visitTraceEvent(value, sha1s, secretsFilter);
+        result[key] = visitTraceEvent(value, sha1s, secretsFilter2);
       }
     }
     return result;
@@ -570,50 +552,60 @@ function visitTraceEvent(object, sha1s, secretsFilter) {
   return object;
 }
 function shouldCaptureSnapshot(metadata) {
-  return _debug.commandsWithTracingSnapshots.has(metadata.type + '.' + metadata.method);
+  const metainfo = import_protocolMetainfo.methodMetainfo.get(metadata.type + "." + metadata.method);
+  return !!metainfo?.snapshot;
 }
 function createBeforeActionTraceEvent(metadata, parentId) {
-  if (metadata.internal || metadata.method.startsWith('tracing')) return null;
+  if (metadata.internal || metadata.method.startsWith("tracing"))
+    return null;
   const event = {
-    type: 'before',
+    type: "before",
     callId: metadata.id,
     startTime: metadata.startTime,
-    apiName: metadata.apiName || metadata.type + '.' + metadata.method,
+    title: metadata.title,
     class: metadata.type,
     method: metadata.method,
     params: metadata.params,
     stepId: metadata.stepId,
     pageId: metadata.pageId
   };
-  if (parentId) event.parentId = parentId;
+  if (parentId)
+    event.parentId = parentId;
   return event;
 }
 function createInputActionTraceEvent(metadata) {
-  if (metadata.internal || metadata.method.startsWith('tracing')) return null;
+  if (metadata.internal || metadata.method.startsWith("tracing"))
+    return null;
   return {
-    type: 'input',
+    type: "input",
     callId: metadata.id,
     point: metadata.point
   };
 }
 function createActionLogTraceEvent(metadata, message) {
-  if (metadata.internal || metadata.method.startsWith('tracing')) return null;
+  if (metadata.internal || metadata.method.startsWith("tracing"))
+    return null;
   return {
-    type: 'log',
+    type: "log",
     callId: metadata.id,
-    time: (0, _time.monotonicTime)(),
+    time: (0, import_time.monotonicTime)(),
     message
   };
 }
 function createAfterActionTraceEvent(metadata) {
-  var _metadata$error;
-  if (metadata.internal || metadata.method.startsWith('tracing')) return null;
+  if (metadata.internal || metadata.method.startsWith("tracing"))
+    return null;
   return {
-    type: 'after',
+    type: "after",
     callId: metadata.id,
     endTime: metadata.endTime,
-    error: (_metadata$error = metadata.error) === null || _metadata$error === void 0 ? void 0 : _metadata$error.error,
+    error: metadata.error?.error,
     result: metadata.result,
     point: metadata.point
   };
-}
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Tracing,
+  shouldCaptureSnapshot
+});