patchright-core 1.57.0 → 1.58.2

package/types/types.d.ts

@@ -12457,6 +12457,12 @@ export interface Locator {
   elementHandle(options?: {
     timeout?: number;
   }): Promise<null|ElementHandle<SVGElement | HTMLElement>>;
+  /**
+   * Returns a human-readable representation of the locator, using the
+   * [locator.description()](https://playwright.dev/docs/api/class-locator#locator-description) if one exists;
+   * otherwise, it generates a string based on the locator's selector.
+   */
+  toString(): string;
   /**
    * When the locator points to a list of elements, this returns an array of locators, pointing to their respective
    * elements.
@@ -13011,8 +13017,9 @@ export interface Locator {
   /**
    * Returns locator description previously set with
    * [locator.describe(description)](https://playwright.dev/docs/api/class-locator#locator-describe). Returns `null` if
-   * no custom description has been set. Prefer `Locator.toString()` for a human-readable representation, as it uses the
-   * description when available.
+   * no custom description has been set. Prefer
+   * [locator.toString()](https://playwright.dev/docs/api/class-locator#locator-to-string) for a human-readable
+   * representation, as it uses the description when available.
    *
    * **Usage**
    *
@@ -14998,14 +15005,6 @@ export interface BrowserType<Unused = {}> {
      */
     deviceScaleFactor?: number;
 
-    /**
-     * **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the
-     * [`headless`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-persistent-context-option-headless)
-     * option will be set `false`.
-     * @deprecated Use [debugging tools](https://playwright.dev/docs/debug) instead.
-     */
-    devtools?: boolean;
-
     /**
      * If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and
      * is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were
@@ -15085,9 +15084,7 @@ export interface BrowserType<Unused = {}> {
     /**
      * Whether to run browser in headless mode. More details for
      * [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and
-     * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the
-     * [`devtools`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-option-devtools) option is
-     * `true`.
+     * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`.
      */
     headless?: boolean;
 
@@ -15428,14 +15425,6 @@ export interface BrowserType<Unused = {}> {
      */
     chromiumSandbox?: boolean;
 
-    /**
-     * **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the
-     * [`headless`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-server-option-headless) option
-     * will be set `false`.
-     * @deprecated Use [debugging tools](https://playwright.dev/docs/debug) instead.
-     */
-    devtools?: boolean;
-
     /**
      * If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and
      * is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were
@@ -15480,9 +15469,7 @@ export interface BrowserType<Unused = {}> {
     /**
      * Whether to run browser in headless mode. More details for
      * [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and
-     * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the
-     * [`devtools`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-option-devtools) option is
-     * `true`.
+     * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`.
      */
     headless?: boolean;
 
@@ -18881,7 +18868,7 @@ export interface ConsoleMessage {
    */
   text(): string;
 
-  type(): "log"|"debug"|"info"|"error"|"warning"|"dir"|"dirxml"|"table"|"trace"|"clear"|"startGroup"|"startGroupCollapsed"|"endGroup"|"assert"|"profile"|"profileEnd"|"count"|"timeEnd";
+  type(): "log"|"debug"|"info"|"error"|"warning"|"dir"|"dirxml"|"table"|"trace"|"clear"|"startGroup"|"startGroupCollapsed"|"endGroup"|"assert"|"profile"|"profileEnd"|"count"|"time"|"timeEnd";
 
   /**
    * The web worker or service worker that produced this console message, if any. Note that console messages from web
@@ -20876,8 +20863,12 @@ export interface Route {
    * [route.fallback([options])](https://playwright.dev/docs/api/class-route#route-fallback) If you want next matching
    * handler in the chain to be invoked.
    *
-   * **NOTE** The `Cookie` header cannot be overridden using this method. If a value is provided, it will be ignored,
-   * and the cookie will be loaded from the browser's cookie store. To set custom cookies, use
+   * **NOTE** Some request headers are **forbidden** and cannot be overridden (for example, `Cookie`, `Host`,
+   * `Content-Length` and others, see
+   * [this MDN page](https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_request_header) for full list). If an
+   * override is provided for a forbidden header, it will be ignored and the original request header will be used.
+   *
+   * To set custom cookies, use
    * [browserContext.addCookies(cookies)](https://playwright.dev/docs/api/class-browsercontext#browser-context-add-cookies).
    *
    * @param options
@@ -21763,14 +21754,6 @@ export interface LaunchOptions {
    */
   chromiumSandbox?: boolean;
 
-  /**
-   * **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the
-   * [`headless`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-option-headless) option will be
-   * set `false`.
-   * @deprecated Use [debugging tools](https://playwright.dev/docs/debug) instead.
-   */
-  devtools?: boolean;
-
   /**
    * If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and
    * is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were
@@ -21815,9 +21798,7 @@ export interface LaunchOptions {
   /**
    * Whether to run browser in headless mode. More details for
    * [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and
-   * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the
-   * [`devtools`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-option-devtools) option is
-   * `true`.
+   * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`.
    */
   headless?: boolean;
 
@@ -21889,6 +21870,12 @@ export interface ConnectOverCDPOptions {
    */
   headers?: { [key: string]: string; };
 
+  /**
+   * Tells Playwright that it runs on the same host as the CDP server. It will enable certain optimizations that rely
+   * upon the file system being the same between Playwright and the Browser.
+   */
+  isLocal?: boolean;
+
   /**
    * Logger sink for Playwright logging. Optional.
    * @deprecated The logs received by the logger are incomplete. Please use tracing instead.

package/lib/server/bidi/third_party/bidiDeserializer.js

@@ -1,98 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-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;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var bidiDeserializer_exports = {};
-__export(bidiDeserializer_exports, {
-  BidiDeserializer: () => BidiDeserializer
-});
-module.exports = __toCommonJS(bidiDeserializer_exports);
-/**
- * @license
- * Copyright 2024 Google Inc.
- * Modifications copyright (c) Microsoft Corporation.
- * SPDX-License-Identifier: Apache-2.0
- */
-class BidiDeserializer {
-  static deserialize(result) {
-    if (!result)
-      return void 0;
-    switch (result.type) {
-      case "array":
-        return result.value?.map((value) => {
-          return BidiDeserializer.deserialize(value);
-        });
-      case "set":
-        return result.value?.reduce((acc, value) => {
-          return acc.add(BidiDeserializer.deserialize(value));
-        }, /* @__PURE__ */ new Set());
-      case "object":
-        return result.value?.reduce((acc, tuple) => {
-          const { key, value } = BidiDeserializer._deserializeTuple(tuple);
-          acc[key] = value;
-          return acc;
-        }, {});
-      case "map":
-        return result.value?.reduce((acc, tuple) => {
-          const { key, value } = BidiDeserializer._deserializeTuple(tuple);
-          return acc.set(key, value);
-        }, /* @__PURE__ */ new Map());
-      case "promise":
-        return {};
-      case "regexp":
-        return new RegExp(result.value.pattern, result.value.flags);
-      case "date":
-        return new Date(result.value);
-      case "undefined":
-        return void 0;
-      case "null":
-        return null;
-      case "number":
-        return BidiDeserializer._deserializeNumber(result.value);
-      case "bigint":
-        return BigInt(result.value);
-      case "boolean":
-        return Boolean(result.value);
-      case "string":
-        return result.value;
-    }
-    throw new Error(`Deserialization of type ${result.type} not supported.`);
-  }
-  static _deserializeNumber(value) {
-    switch (value) {
-      case "-0":
-        return -0;
-      case "NaN":
-        return NaN;
-      case "Infinity":
-        return Infinity;
-      case "-Infinity":
-        return -Infinity;
-      default:
-        return value;
-    }
-  }
-  static _deserializeTuple([serializedKey, serializedValue]) {
-    const key = typeof serializedKey === "string" ? serializedKey : BidiDeserializer.deserialize(serializedKey);
-    const value = BidiDeserializer.deserialize(serializedValue);
-    return { key, value };
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  BidiDeserializer
-});

package/lib/server/trace/test/inMemorySnapshotter.js

@@ -1,87 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-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;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var inMemorySnapshotter_exports = {};
-__export(inMemorySnapshotter_exports, {
-  InMemorySnapshotter: () => InMemorySnapshotter
-});
-module.exports = __toCommonJS(inMemorySnapshotter_exports);
-var import_snapshotStorage = require("../../../../../trace-viewer/src/sw/snapshotStorage");
-var import_utils = require("../../../utils");
-var import_harTracer = require("../../har/harTracer");
-var import_snapshotter = require("../recorder/snapshotter");
-class InMemorySnapshotter {
-  constructor(context) {
-    this._blobs = /* @__PURE__ */ new Map();
-    this._snapshotReadyPromises = /* @__PURE__ */ new Map();
-    this._snapshotCount = 0;
-    this._snapshotter = new import_snapshotter.Snapshotter(context, this);
-    this._harTracer = new import_harTracer.HarTracer(context, null, this, { content: "attach", includeTraceInfo: true, recordRequestOverrides: false, waitForContentOnStop: false });
-    this._storage = new import_snapshotStorage.SnapshotStorage();
-  }
-  async initialize() {
-    await this._snapshotter.start();
-    this._harTracer.start({ omitScripts: true });
-  }
-  async reset() {
-    await this._snapshotter.reset();
-    await this._harTracer.flush();
-    this._harTracer.stop();
-    this._harTracer.start({ omitScripts: true });
-  }
-  async dispose() {
-    this._snapshotter.dispose();
-    await this._harTracer.flush();
-    this._harTracer.stop();
-  }
-  async captureSnapshot(page, callId, snapshotName) {
-    if (this._snapshotReadyPromises.has(snapshotName))
-      throw new Error("Duplicate snapshot name: " + snapshotName);
-    this._snapshotter.captureSnapshot(page, callId, snapshotName).catch(() => {
-    });
-    const promise = new import_utils.ManualPromise();
-    this._snapshotReadyPromises.set(snapshotName, promise);
-    return promise;
-  }
-  onEntryStarted(entry) {
-  }
-  onEntryFinished(entry) {
-    this._storage.addResource("", entry);
-  }
-  onContentBlob(sha1, buffer) {
-    this._blobs.set(sha1, buffer);
-  }
-  onSnapshotterBlob(blob) {
-    this._blobs.set(blob.sha1, blob.buffer);
-  }
-  onFrameSnapshot(snapshot) {
-    ++this._snapshotCount;
-    const renderer = this._storage.addFrameSnapshot("", snapshot, []);
-    this._snapshotReadyPromises.get(snapshot.snapshotName || "")?.resolve(renderer);
-  }
-  async resourceContentForTest(sha1) {
-    return this._blobs.get(sha1);
-  }
-  snapshotCount() {
-    return this._snapshotCount;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  InMemorySnapshotter
-});