patchright-core 1.51.2 → 1.52.0

package/types/types.d.ts

@@ -3974,9 +3974,9 @@ export interface Page {
    *
    * **NOTE** Enabling routing disables http cache.
    *
-   * @param url A glob pattern, regex pattern or predicate receiving [URL] to match while routing. When a
-   * [`baseURL`](https://playwright.dev/docs/api/class-browser#browser-new-context-option-base-url) via the context
-   * options was provided and the passed URL is a path, it gets merged via the
+   * @param url A glob pattern, regex pattern, or predicate that receives a [URL] to match during routing. If
+   * [`baseURL`](https://playwright.dev/docs/api/class-browser#browser-new-context-option-base-url) is set in the
+   * context options and the provided URL is a string that does not start with `*`, it is resolved using the
    * [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor.
    * @param handler handler function to route the request.
    * @param options
@@ -9068,9 +9068,9 @@ export interface BrowserContext {
    *
    * **NOTE** Enabling routing disables http cache.
    *
-   * @param url A glob pattern, regex pattern or predicate receiving [URL] to match while routing. When a
-   * [`baseURL`](https://playwright.dev/docs/api/class-browser#browser-new-context-option-base-url) via the context
-   * options was provided and the passed URL is a path, it gets merged via the
+   * @param url A glob pattern, regex pattern, or predicate that receives a [URL] to match during routing. If
+   * [`baseURL`](https://playwright.dev/docs/api/class-browser#browser-new-context-option-base-url) is set in the
+   * context options and the provided URL is a string that does not start with `*`, it is resolved using the
    * [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor.
    * @param handler handler function to route the request.
    * @param options
@@ -9274,9 +9274,6 @@ export interface BrowserContext {
      * Set to `true` to include [IndexedDB](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API) in the storage
      * state snapshot. If your application uses IndexedDB to store authentication tokens, like Firebase Authentication,
      * enable this.
-     *
-     * **NOTE** IndexedDBs with typed arrays are currently not supported.
-     *
      */
     indexedDB?: boolean;
 
@@ -12481,6 +12478,12 @@ export interface Locator {
    * @param options
    */
   ariaSnapshot(options?: {
+    /**
+     * Generate symbolic reference for each element. One can use `aria-ref=<ref>` locator immediately after capturing the
+     * snapshot to perform actions on the element.
+     */
+    ref?: boolean;
+
     /**
      * Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`
      * option in the config, or by using the
@@ -14704,11 +14707,15 @@ export interface BrowserType<Unused = {}> {
    * Launches browser that uses persistent storage located at
    * [`userDataDir`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-persistent-context-option-user-data-dir)
    * and returns the only context. Closing this context will automatically close the browser.
-   * @param userDataDir Path to a User Data Directory, which stores browser session data like cookies and local storage. More details for
+   * @param userDataDir Path to a User Data Directory, which stores browser session data like cookies and local storage. Pass an empty
+   * string to create a temporary directory.
+   *
+   * More details for
    * [Chromium](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md#introduction) and
-   * [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options#User_Profile). Note that Chromium's
-   * user data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty
-   * string to use a temporary directory instead.
+   * [Firefox](https://wiki.mozilla.org/Firefox/CommandLineOptions#User_profile). Chromium's user data directory is the
+   * **parent** directory of the "Profile Path" seen at `chrome://version`.
+   *
+   * Note that browsers do not allow launching multiple instances with the same User Data Directory.
    * @param options
    */
   launchPersistentContext(userDataDir: string, options?: {
@@ -14927,7 +14934,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://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the
+     * [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`.
      */
@@ -15321,7 +15328,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://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the
+     * [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`.
      */
@@ -17563,6 +17570,13 @@ export interface APIRequest {
      */
     ignoreHTTPSErrors?: boolean;
 
+    /**
+     * Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
+     * exceeded. Defaults to `20`. Pass `0` to not follow redirects. This can be overwritten for each request
+     * individually.
+     */
+    maxRedirects?: number;
+
     /**
      * Network proxy settings.
      */
@@ -20769,6 +20783,11 @@ export interface Route {
    * request to the network, other matching handlers won't be invoked. Use
    * [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
+   * [browserContext.addCookies(cookies)](https://playwright.dev/docs/api/class-browsercontext#browser-context-add-cookies).
+   *
    * @param options
    */
   continue(options?: {
@@ -21696,7 +21715,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://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the
+   * [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`.
    */

package/lib/server/isomorphic/utilityScriptSerializers.js

@@ -1,229 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.serializeAsCallArgument = exports.parseEvaluationResultValue = void 0;
-exports.source = source;
-/**
- * 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.
- */
-
-function source() {
-  function isRegExp(obj) {
-    try {
-      return obj instanceof RegExp || Object.prototype.toString.call(obj) === '[object RegExp]';
-    } catch (error) {
-      return false;
-    }
-  }
-  function isDate(obj) {
-    try {
-      return obj instanceof Date || Object.prototype.toString.call(obj) === '[object Date]';
-    } catch (error) {
-      return false;
-    }
-  }
-  function isURL(obj) {
-    try {
-      return obj instanceof URL || Object.prototype.toString.call(obj) === '[object URL]';
-    } catch (error) {
-      return false;
-    }
-  }
-  function isError(obj) {
-    try {
-      var _Object$getPrototypeO;
-      return obj instanceof Error || obj && ((_Object$getPrototypeO = Object.getPrototypeOf(obj)) === null || _Object$getPrototypeO === void 0 ? void 0 : _Object$getPrototypeO.name) === 'Error';
-    } catch (error) {
-      return false;
-    }
-  }
-  function parseEvaluationResultValue(value, handles = [], refs = new Map()) {
-    if (Object.is(value, undefined)) return undefined;
-    if (typeof value === 'object' && value) {
-      if ('ref' in value) return refs.get(value.ref);
-      if ('v' in value) {
-        if (value.v === 'undefined') return undefined;
-        if (value.v === 'null') return null;
-        if (value.v === 'NaN') return NaN;
-        if (value.v === 'Infinity') return Infinity;
-        if (value.v === '-Infinity') return -Infinity;
-        if (value.v === '-0') return -0;
-        return undefined;
-      }
-      if ('d' in value) return new Date(value.d);
-      if ('u' in value) return new URL(value.u);
-      if ('bi' in value) return BigInt(value.bi);
-      if ('e' in value) {
-        const error = new Error(value.e.m);
-        error.name = value.e.n;
-        error.stack = value.e.s;
-        return error;
-      }
-      if ('r' in value) return new RegExp(value.r.p, value.r.f);
-      if ('a' in value) {
-        const result = [];
-        refs.set(value.id, result);
-        for (const a of value.a) result.push(parseEvaluationResultValue(a, handles, refs));
-        return result;
-      }
-      if ('o' in value) {
-        const result = {};
-        refs.set(value.id, result);
-        for (const {
-          k,
-          v
-        } of value.o) result[k] = parseEvaluationResultValue(v, handles, refs);
-        return result;
-      }
-      if ('h' in value) return handles[value.h];
-    }
-    return value;
-  }
-  function serializeAsCallArgument(value, handleSerializer) {
-    return serialize(value, handleSerializer, {
-      visited: new Map(),
-      lastId: 0
-    });
-  }
-  function serialize(value, handleSerializer, visitorInfo) {
-    if (value && typeof value === 'object') {
-      // eslint-disable-next-line no-restricted-globals
-      if (typeof globalThis.Window === 'function' && value instanceof globalThis.Window) return 'ref: <Window>';
-      // eslint-disable-next-line no-restricted-globals
-      if (typeof globalThis.Document === 'function' && value instanceof globalThis.Document) return 'ref: <Document>';
-      // eslint-disable-next-line no-restricted-globals
-      if (typeof globalThis.Node === 'function' && value instanceof globalThis.Node) return 'ref: <Node>';
-    }
-    return innerSerialize(value, handleSerializer, visitorInfo);
-  }
-  function innerSerialize(value, handleSerializer, visitorInfo) {
-    const result = handleSerializer(value);
-    if ('fallThrough' in result) value = result.fallThrough;else return result;
-    if (typeof value === 'symbol') return {
-      v: 'undefined'
-    };
-    if (Object.is(value, undefined)) return {
-      v: 'undefined'
-    };
-    if (Object.is(value, null)) return {
-      v: 'null'
-    };
-    if (Object.is(value, NaN)) return {
-      v: 'NaN'
-    };
-    if (Object.is(value, Infinity)) return {
-      v: 'Infinity'
-    };
-    if (Object.is(value, -Infinity)) return {
-      v: '-Infinity'
-    };
-    if (Object.is(value, -0)) return {
-      v: '-0'
-    };
-    if (typeof value === 'boolean') return value;
-    if (typeof value === 'number') return value;
-    if (typeof value === 'string') return value;
-    if (typeof value === 'bigint') return {
-      bi: value.toString()
-    };
-    if (isError(value)) {
-      var _value$stack;
-      let stack;
-      if ((_value$stack = value.stack) !== null && _value$stack !== void 0 && _value$stack.startsWith(value.name + ': ' + value.message)) {
-        // v8
-        stack = value.stack;
-      } else {
-        stack = `${value.name}: ${value.message}\n${value.stack}`;
-      }
-      return {
-        e: {
-          n: value.name,
-          m: value.message,
-          s: stack
-        }
-      };
-    }
-    if (isDate(value)) return {
-      d: value.toJSON()
-    };
-    if (isURL(value)) return {
-      u: value.toJSON()
-    };
-    if (isRegExp(value)) return {
-      r: {
-        p: value.source,
-        f: value.flags
-      }
-    };
-    const id = visitorInfo.visited.get(value);
-    if (id) return {
-      ref: id
-    };
-    if (Array.isArray(value)) {
-      const a = [];
-      const id = ++visitorInfo.lastId;
-      visitorInfo.visited.set(value, id);
-      for (let i = 0; i < value.length; ++i) a.push(serialize(value[i], handleSerializer, visitorInfo));
-      return {
-        a,
-        id
-      };
-    }
-    if (typeof value === 'object') {
-      const o = [];
-      const id = ++visitorInfo.lastId;
-      visitorInfo.visited.set(value, id);
-      for (const name of Object.keys(value)) {
-        let item;
-        try {
-          item = value[name];
-        } catch (e) {
-          continue; // native bindings will throw sometimes
-        }
-        if (name === 'toJSON' && typeof item === 'function') o.push({
-          k: name,
-          v: {
-            o: [],
-            id: 0
-          }
-        });else o.push({
-          k: name,
-          v: serialize(item, handleSerializer, visitorInfo)
-        });
-      }
-      let jsonWrapper;
-      try {
-        // If Object.keys().length === 0 we fall back to toJSON if it exists
-        if (o.length === 0 && value.toJSON && typeof value.toJSON === 'function') jsonWrapper = {
-          value: value.toJSON()
-        };
-      } catch (e) {}
-      if (jsonWrapper) return innerSerialize(jsonWrapper.value, handleSerializer, visitorInfo);
-      return {
-        o,
-        id
-      };
-    }
-  }
-  return {
-    parseEvaluationResultValue,
-    serializeAsCallArgument
-  };
-}
-const result = source();
-const parseEvaluationResultValue = exports.parseEvaluationResultValue = result.parseEvaluationResultValue;
-const serializeAsCallArgument = exports.serializeAsCallArgument = result.serializeAsCallArgument;