patchright-core 1.49.2 → 1.50.1

package/types/types.d.ts

@@ -3609,8 +3609,6 @@ export interface Page {
   /**
    * Returns the PDF buffer.
    *
-   * **NOTE** Generating a pdf is currently only supported in Chromium headless.
-   *
    * `page.pdf()` generates a pdf of the page with `print` css media. To generate a pdf with `screen` media, call
    * [page.emulateMedia([options])](https://playwright.dev/docs/api/class-page#page-emulate-media) before calling
    * `page.pdf()`:
@@ -4296,7 +4294,7 @@ export interface Page {
    * takes priority over
    * [page.setDefaultTimeout(timeout)](https://playwright.dev/docs/api/class-page#page-set-default-timeout).
    *
-   * @param timeout Maximum time in milliseconds
+   * @param timeout Maximum time in milliseconds. Pass `0` to disable timeout.
    */
   setDefaultTimeout(timeout: number): void;
 
@@ -8961,9 +8959,13 @@ export interface BrowserContext {
   /**
    * Grants specified permissions to the browser context. Only grants corresponding permissions to the given origin if
    * specified.
-   * @param permissions A permission or an array of permissions to grant. Permissions can be one of the following values:
+   * @param permissions A list of permissions to grant.
+   *
+   * **NOTE** Supported permissions differ between browsers, and even between different versions of the same browser.
+   * Any permission may stop working after an update.
+   *
+   * Here are some permissions that may be supported by some browsers:
    * - `'accelerometer'`
-   * - `'accessibility-events'`
    * - `'ambient-light-sensor'`
    * - `'background-sync'`
    * - `'camera'`
@@ -9191,7 +9193,7 @@ export interface BrowserContext {
    * take priority over
    * [browserContext.setDefaultTimeout(timeout)](https://playwright.dev/docs/api/class-browsercontext#browser-context-set-default-timeout).
    *
-   * @param timeout Maximum time in milliseconds
+   * @param timeout Maximum time in milliseconds. Pass `0` to disable timeout.
    */
   setDefaultTimeout(timeout: number): void;
 
@@ -9587,10 +9589,11 @@ export interface Browser {
    * In case this browser is connected to, clears all created contexts belonging to this browser and disconnects from
    * the browser server.
    *
-   * **NOTE** This is similar to force quitting the browser. Therefore, you should call
+   * **NOTE** This is similar to force-quitting the browser. To close pages gracefully and ensure you receive page close
+   * events, call
    * [browserContext.close([options])](https://playwright.dev/docs/api/class-browsercontext#browser-context-close) on
-   * any [BrowserContext](https://playwright.dev/docs/api/class-browsercontext)'s you explicitly created earlier with
-   * [browser.newContext([options])](https://playwright.dev/docs/api/class-browser#browser-new-context) **before**
+   * any [BrowserContext](https://playwright.dev/docs/api/class-browsercontext) instances you explicitly created earlier
+   * using [browser.newContext([options])](https://playwright.dev/docs/api/class-browser#browser-new-context) **before**
    * calling [browser.close([options])](https://playwright.dev/docs/api/class-browser#browser-close).
    *
    * The [Browser](https://playwright.dev/docs/api/class-browser) object itself is considered to be disposed and cannot
@@ -12912,7 +12915,6 @@ export interface Locator {
    * live objects to be passed into the event:
    *
    * ```js
-   * // Note you can only create DataTransfer in Chromium and Firefox
    * const dataTransfer = await page.evaluateHandle(() => new DataTransfer());
    * await locator.dispatchEvent('dragstart', { dataTransfer });
    * ```
@@ -13676,7 +13678,9 @@ export interface Locator {
   }): Promise<boolean>;
 
   /**
-   * Returns whether the element is [editable](https://playwright.dev/docs/actionability#editable).
+   * Returns whether the element is [editable](https://playwright.dev/docs/actionability#editable). If the target element is not an `<input>`,
+   * `<textarea>`, `<select>`, `[contenteditable]` and does not have a role allowing `[aria-readonly]`, this method
+   * throws an error.
    *
    * **NOTE** If you need to assert that an element is editable, prefer
    * [expect(locator).toBeEditable([options])](https://playwright.dev/docs/api/class-locatorassertions#locator-assertions-to-be-editable)
@@ -13848,18 +13852,22 @@ export interface Locator {
   /**
    * Creates a locator matching all elements that match one or both of the two locators.
    *
-   * Note that when both locators match something, the resulting locator will have multiple matches and violate
-   * [locator strictness](https://playwright.dev/docs/locators#strictness) guidelines.
+   * Note that when both locators match something, the resulting locator will have multiple matches, potentially causing
+   * a [locator strictness](https://playwright.dev/docs/locators#strictness) violation.
    *
    * **Usage**
    *
    * Consider a scenario where you'd like to click on a "New email" button, but sometimes a security settings dialog
    * shows up instead. In this case, you can wait for either a "New email" button, or a dialog and act accordingly.
    *
+   * **NOTE** If both "New email" button and security dialog appear on screen, the "or" locator will match both of them,
+   * possibly throwing the ["strict mode violation" error](https://playwright.dev/docs/locators#strictness). In this case, you can use
+   * [locator.first()](https://playwright.dev/docs/api/class-locator#locator-first) to only match one of them.
+   *
    * ```js
    * const newEmail = page.getByRole('button', { name: 'New' });
    * const dialog = page.getByText('Confirm security settings');
-   * await expect(newEmail.or(dialog)).toBeVisible();
+   * await expect(newEmail.or(dialog).first()).toBeVisible();
    * if (await dialog.isVisible())
    *   await page.getByRole('button', { name: 'Dismiss' }).click();
    * await newEmail.click();
@@ -14558,6 +14566,11 @@ export interface BrowserType<Unused = {}> {
    *
    * **NOTE** Connecting over the Chrome DevTools Protocol is only supported for Chromium-based browsers.
    *
+   * **NOTE** This connection is significantly lower fidelity than the Playwright protocol connection via
+   * [browserType.connect(wsEndpoint[, options])](https://playwright.dev/docs/api/class-browsertype#browser-type-connect).
+   * If you are experiencing issues or attempting to use advanced functionality, you probably want to use
+   * [browserType.connect(wsEndpoint[, options])](https://playwright.dev/docs/api/class-browsertype#browser-type-connect).
+   *
    * **Usage**
    *
    * ```js
@@ -14583,6 +14596,11 @@ export interface BrowserType<Unused = {}> {
    *
    * **NOTE** Connecting over the Chrome DevTools Protocol is only supported for Chromium-based browsers.
    *
+   * **NOTE** This connection is significantly lower fidelity than the Playwright protocol connection via
+   * [browserType.connect(wsEndpoint[, options])](https://playwright.dev/docs/api/class-browsertype#browser-type-connect).
+   * If you are experiencing issues or attempting to use advanced functionality, you probably want to use
+   * [browserType.connect(wsEndpoint[, options])](https://playwright.dev/docs/api/class-browsertype#browser-type-connect).
+   *
    * **Usage**
    *
    * ```js
@@ -14597,10 +14615,14 @@ export interface BrowserType<Unused = {}> {
    */
   connectOverCDP(options: ConnectOverCDPOptions & { wsEndpoint?: string }): Promise<Browser>;
   /**
-   * This method attaches Playwright to an existing browser instance. When connecting to another browser launched via
-   * `BrowserType.launchServer` in Node.js, the major and minor version needs to match the client version (1.2.3 → is
-   * compatible with 1.2.x).
-   * @param wsEndpoint A browser websocket endpoint to connect to.
+   * This method attaches Playwright to an existing browser instance created via
+   * [browserType.launchServer([options])](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-server).
+   *
+   * **NOTE** The major and minor version of the Playwright instance that connects needs to match the version of
+   * Playwright that launches the browser (1.2.3 → is compatible with 1.2.x).
+   *
+   * @param wsEndpoint A Playwright browser websocket endpoint to connect to. You obtain this endpoint via
+   * [browserServer.wsEndpoint()](https://playwright.dev/docs/api/class-browserserver#browser-server-ws-endpoint).
    * @param options
    */
   connect(wsEndpoint: string, options?: ConnectOptions): Promise<Browser>;
@@ -14611,10 +14633,14 @@ export interface BrowserType<Unused = {}> {
    * @deprecated
    */
   /**
-   * This method attaches Playwright to an existing browser instance. When connecting to another browser launched via
-   * `BrowserType.launchServer` in Node.js, the major and minor version needs to match the client version (1.2.3 → is
-   * compatible with 1.2.x).
-   * @param wsEndpoint A browser websocket endpoint to connect to.
+   * This method attaches Playwright to an existing browser instance created via
+   * [browserType.launchServer([options])](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-server).
+   *
+   * **NOTE** The major and minor version of the Playwright instance that connects needs to match the version of
+   * Playwright that launches the browser (1.2.3 → is compatible with 1.2.x).
+   *
+   * @param wsEndpoint A Playwright browser websocket endpoint to connect to. You obtain this endpoint via
+   * [browserServer.wsEndpoint()](https://playwright.dev/docs/api/class-browserserver#browser-server-ws-endpoint).
    * @param options
    */
   connect(options: ConnectOptions & { wsEndpoint?: string }): Promise<Browser>;
@@ -14711,7 +14737,7 @@ export interface BrowserType<Unused = {}> {
     /**
      * Browser distribution channel.
      *
-     * Use "chromium" to [opt in to new headless mode](https://playwright.dev/docs/browsers#opt-in-to-new-headless-mode).
+     * Use "chromium" to [opt in to new headless mode](https://playwright.dev/docs/browsers#chromium-new-headless-mode).
      *
      * Use "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", or
      * "msedge-canary" to use branded [Google Chrome and Microsoft Edge](https://playwright.dev/docs/browsers#google-chrome--microsoft-edge).
@@ -15210,7 +15236,7 @@ export interface BrowserType<Unused = {}> {
     /**
      * Browser distribution channel.
      *
-     * Use "chromium" to [opt in to new headless mode](https://playwright.dev/docs/browsers#opt-in-to-new-headless-mode).
+     * Use "chromium" to [opt in to new headless mode](https://playwright.dev/docs/browsers#chromium-new-headless-mode).
      *
      * Use "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", or
      * "msedge-canary" to use branded [Google Chrome and Microsoft Edge](https://playwright.dev/docs/browsers#google-chrome--microsoft-edge).
@@ -16599,11 +16625,6 @@ export interface AndroidDevice {
      */
     colorScheme?: null|"light"|"dark"|"no-preference";
 
-    /**
-     * Optional package name to launch instead of default Chrome for Android.
-     */
-    command?: string;
-
     /**
      * Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about
      * [emulating devices with device scale factor](https://playwright.dev/docs/emulation#devices).
@@ -16712,6 +16733,11 @@ export interface AndroidDevice {
      */
     permissions?: Array<string>;
 
+    /**
+     * Optional package name to launch instead of default Chrome for Android.
+     */
+    pkg?: string;
+
     /**
      * Network proxy settings.
      */
@@ -18586,6 +18612,19 @@ export interface Clock {
    * await page.clock.pauseAt('2020-02-02');
    * ```
    *
+   * For best results, install the clock before navigating the page and set it to a time slightly before the intended
+   * test time. This ensures that all timers run normally during page loading, preventing the page from getting stuck.
+   * Once the page has fully loaded, you can safely use
+   * [clock.pauseAt(time)](https://playwright.dev/docs/api/class-clock#clock-pause-at) to pause the clock.
+   *
+   * ```js
+   * // Initialize clock with some time before the test time and let the page load
+   * // naturally. `Date.now` will progress as the timers fire.
+   * await page.clock.install({ time: new Date('2024-12-10T08:00:00') });
+   * await page.goto('http://localhost:3333');
+   * await page.clock.pauseAt(new Date('2024-12-10T10:00:00'));
+   * ```
+   *
    * @param time Time to pause at.
    */
   pauseAt(time: number|string|Date): Promise<void>;
@@ -21548,7 +21587,7 @@ export interface LaunchOptions {
   /**
    * Browser distribution channel.
    *
-   * Use "chromium" to [opt in to new headless mode](https://playwright.dev/docs/browsers#opt-in-to-new-headless-mode).
+   * Use "chromium" to [opt in to new headless mode](https://playwright.dev/docs/browsers#chromium-new-headless-mode).
    *
    * Use "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", or
    * "msedge-canary" to use branded [Google Chrome and Microsoft Edge](https://playwright.dev/docs/browsers#google-chrome--microsoft-edge).

package/bin/README.md

@@ -1,2 +0,0 @@
-See building instructions at [`/browser_patches/winldd/README.md`](../../../browser_patches/winldd/README.md)
-

package/lib/server/ariaSnapshot.js

@@ -1,33 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.parseAriaSnapshot = parseAriaSnapshot;
-exports.parseYamlForAriaSnapshot = parseYamlForAriaSnapshot;
-var _ariaSnapshot = require("../utils/isomorphic/ariaSnapshot");
-var _utilsBundle = require("../utilsBundle");
-/**
- * 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 parseAriaSnapshot(text) {
-  return (0, _ariaSnapshot.parseYamlTemplate)(parseYamlForAriaSnapshot(text));
-}
-function parseYamlForAriaSnapshot(text) {
-  const parsed = _utilsBundle.yaml.parse(text);
-  if (!Array.isArray(parsed)) throw new Error('Expected object key starting with "- ":\n\n' + text + '\n');
-  return parsed;
-}

package/lib/server/recorder/recorderInTraceViewer.js

@@ -1,144 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.RecorderInTraceViewer = void 0;
-var _path = _interopRequireDefault(require("path"));
-var _events = require("events");
-var _traceViewer = require("../trace/viewer/traceViewer");
-var _manualPromise = require("../../utils/manualPromise");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-/**
- * 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.
- */
-
-class RecorderInTraceViewer extends _events.EventEmitter {
-  static factory(context) {
-    return async recorder => {
-      const transport = new RecorderTransport();
-      const trace = _path.default.join(context._browser.options.tracesDir, 'trace');
-      const {
-        wsEndpointForTest,
-        tracePage,
-        traceServer
-      } = await openApp(trace, {
-        transport,
-        headless: !context._browser.options.headful
-      });
-      return new RecorderInTraceViewer(transport, tracePage, traceServer, wsEndpointForTest);
-    };
-  }
-  constructor(transport, tracePage, traceServer, wsEndpointForTest) {
-    super();
-    this.wsEndpointForTest = void 0;
-    this._transport = void 0;
-    this._tracePage = void 0;
-    this._traceServer = void 0;
-    this._transport = transport;
-    this._transport.eventSink.resolve(this);
-    this._tracePage = tracePage;
-    this._traceServer = traceServer;
-    this.wsEndpointForTest = wsEndpointForTest;
-    this._tracePage.once('close', () => {
-      this.close();
-    });
-  }
-  async close() {
-    await this._tracePage.context().close({
-      reason: 'Recorder window closed'
-    });
-    await this._traceServer.stop();
-  }
-  async setPaused(paused) {
-    this._transport.deliverEvent('setPaused', {
-      paused
-    });
-  }
-  async setMode(mode) {
-    this._transport.deliverEvent('setMode', {
-      mode
-    });
-  }
-  async setRunningFile(file) {
-    this._transport.deliverEvent('setRunningFile', {
-      file
-    });
-  }
-  async elementPicked(elementInfo, userGesture) {
-    this._transport.deliverEvent('elementPicked', {
-      elementInfo,
-      userGesture
-    });
-  }
-  async updateCallLogs(callLogs) {
-    this._transport.deliverEvent('updateCallLogs', {
-      callLogs
-    });
-  }
-  async setSources(sources) {
-    this._transport.deliverEvent('setSources', {
-      sources
-    });
-    if (process.env.PWTEST_CLI_IS_UNDER_TEST && sources.length) {
-      if (process._didSetSourcesForTest(sources[0].text)) this.close();
-    }
-  }
-  async setActions(actions, sources) {
-    this._transport.deliverEvent('setActions', {
-      actions,
-      sources
-    });
-  }
-}
-exports.RecorderInTraceViewer = RecorderInTraceViewer;
-async function openApp(trace, options) {
-  const traceServer = await (0, _traceViewer.startTraceViewerServer)(options);
-  await (0, _traceViewer.installRootRedirect)(traceServer, [trace], {
-    ...options,
-    webApp: 'recorder.html'
-  });
-  const page = await (0, _traceViewer.openTraceViewerApp)(traceServer.urlPrefix('precise'), 'chromium', options);
-  return {
-    wsEndpointForTest: page.context()._browser.options.wsEndpoint,
-    tracePage: page,
-    traceServer
-  };
-}
-class RecorderTransport {
-  constructor() {
-    this._connected = new _manualPromise.ManualPromise();
-    this.eventSink = new _manualPromise.ManualPromise();
-    this.sendEvent = void 0;
-    this.close = void 0;
-  }
-  onconnect() {
-    this._connected.resolve();
-  }
-  async dispatch(method, params) {
-    const eventSink = await this.eventSink;
-    eventSink.emit('event', {
-      event: method,
-      params
-    });
-  }
-  onclose() {}
-  deliverEvent(method, params) {
-    this._connected.then(() => {
-      var _this$sendEvent;
-      return (_this$sendEvent = this.sendEvent) === null || _this$sendEvent === void 0 ? void 0 : _this$sendEvent.call(this, method, params);
-    });
-  }
-}

package/lib/utils/isomorphic/recorderUtils.js

@@ -1,227 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.buildFullSelector = buildFullSelector;
-exports.toKeyboardModifiers = toKeyboardModifiers;
-exports.traceParamsForAction = traceParamsForAction;
-/**
- * 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 buildFullSelector(framePath, selector) {
-  return [...framePath, selector].join(' >> internal:control=enter-frame >> ');
-}
-const kDefaultTimeout = 5_000;
-function traceParamsForAction(actionInContext) {
-  const {
-    action
-  } = actionInContext;
-  switch (action.name) {
-    case 'navigate':
-      {
-        const params = {
-          url: action.url
-        };
-        return {
-          method: 'goto',
-          apiName: 'page.goto',
-          params
-        };
-      }
-    case 'openPage':
-    case 'closePage':
-      throw new Error('Not reached');
-  }
-  const selector = buildFullSelector(actionInContext.frame.framePath, action.selector);
-  switch (action.name) {
-    case 'click':
-      {
-        const params = {
-          selector,
-          strict: true,
-          modifiers: toKeyboardModifiers(action.modifiers),
-          button: action.button,
-          clickCount: action.clickCount,
-          position: action.position
-        };
-        return {
-          method: 'click',
-          apiName: 'locator.click',
-          params
-        };
-      }
-    case 'press':
-      {
-        const params = {
-          selector,
-          strict: true,
-          key: [...toKeyboardModifiers(action.modifiers), action.key].join('+')
-        };
-        return {
-          method: 'press',
-          apiName: 'locator.press',
-          params
-        };
-      }
-    case 'fill':
-      {
-        const params = {
-          selector,
-          strict: true,
-          value: action.text
-        };
-        return {
-          method: 'fill',
-          apiName: 'locator.fill',
-          params
-        };
-      }
-    case 'setInputFiles':
-      {
-        const params = {
-          selector,
-          strict: true,
-          localPaths: action.files
-        };
-        return {
-          method: 'setInputFiles',
-          apiName: 'locator.setInputFiles',
-          params
-        };
-      }
-    case 'check':
-      {
-        const params = {
-          selector,
-          strict: true
-        };
-        return {
-          method: 'check',
-          apiName: 'locator.check',
-          params
-        };
-      }
-    case 'uncheck':
-      {
-        const params = {
-          selector,
-          strict: true
-        };
-        return {
-          method: 'uncheck',
-          apiName: 'locator.uncheck',
-          params
-        };
-      }
-    case 'select':
-      {
-        const params = {
-          selector,
-          strict: true,
-          options: action.options.map(option => ({
-            value: option
-          }))
-        };
-        return {
-          method: 'selectOption',
-          apiName: 'locator.selectOption',
-          params
-        };
-      }
-    case 'assertChecked':
-      {
-        const params = {
-          selector: action.selector,
-          expression: 'to.be.checked',
-          isNot: !action.checked,
-          timeout: kDefaultTimeout
-        };
-        return {
-          method: 'expect',
-          apiName: 'expect.toBeChecked',
-          params
-        };
-      }
-    case 'assertText':
-      {
-        const params = {
-          selector,
-          expression: 'to.have.text',
-          expectedText: [],
-          isNot: false,
-          timeout: kDefaultTimeout
-        };
-        return {
-          method: 'expect',
-          apiName: 'expect.toContainText',
-          params
-        };
-      }
-    case 'assertValue':
-      {
-        const params = {
-          selector,
-          expression: 'to.have.value',
-          expectedValue: undefined,
-          isNot: false,
-          timeout: kDefaultTimeout
-        };
-        return {
-          method: 'expect',
-          apiName: 'expect.toHaveValue',
-          params
-        };
-      }
-    case 'assertVisible':
-      {
-        const params = {
-          selector,
-          expression: 'to.be.visible',
-          isNot: false,
-          timeout: kDefaultTimeout
-        };
-        return {
-          method: 'expect',
-          apiName: 'expect.toBeVisible',
-          params
-        };
-      }
-    case 'assertSnapshot':
-      {
-        const params = {
-          selector,
-          expression: 'to.match.snapshot',
-          expectedText: [],
-          isNot: false,
-          timeout: kDefaultTimeout
-        };
-        return {
-          method: 'expect',
-          apiName: 'expect.toMatchAriaSnapshot',
-          params
-        };
-      }
-  }
-}
-function toKeyboardModifiers(modifiers) {
-  const result = [];
-  if (modifiers & 1) result.push('Alt');
-  if (modifiers & 2) result.push('ControlOrMeta');
-  if (modifiers & 4) result.push('ControlOrMeta');
-  if (modifiers & 8) result.push('Shift');
-  return result;
-}