chrome-devtools-frontend 1.0.1367881 → 1.0.1380117

package/front_end/third_party/puppeteer/package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "puppeteer-core",
-  "version": "23.5.2",
+  "version": "23.7.1",
   "description": "A high-level API to control headless Chrome over the DevTools Protocol",
   "keywords": [
     "puppeteer",
@@ -100,9 +100,9 @@
       ]
     },
     "build:types": {
-      "command": "api-extractor run --local && eslint --cache-location .eslintcache --cache --ext=ts --no-ignore --no-eslintrc -c=../../.eslintrc.types.cjs --fix lib/types.d.ts",
+      "command": "api-extractor run --local && eslint --cache-location .eslintcache --cache --no-ignore --no-config-lookup -c=../../eslint.types.config.mjs --fix lib/types.d.ts",
       "files": [
-        "../../.eslintrc.types.cjs",
+        "../../eslint.types.config.mjs",
         "api-extractor.json",
         "lib/esm/puppeteer/types.d.ts",
         "tsconfig.json"
@@ -134,18 +134,18 @@
   "author": "The Chromium Authors",
   "license": "Apache-2.0",
   "dependencies": {
-    "@puppeteer/browsers": "2.4.0",
+    "@puppeteer/browsers": "2.4.1",
     "chromium-bidi": "0.8.0",
     "debug": "^4.3.7",
-    "devtools-protocol": "0.0.1342118",
+    "devtools-protocol": "0.0.1354347",
     "typed-query-selector": "^2.12.0",
     "ws": "^8.18.0"
   },
   "devDependencies": {
-    "@types/chrome": "0.0.277",
+    "@types/chrome": "0.0.280",
     "@types/debug": "4.1.12",
-    "@types/node": "18.17.15",
-    "@types/ws": "8.5.12",
+    "@types/node": "^18.17.15",
+    "@types/ws": "8.5.13",
     "mitt": "3.0.1",
     "parsel-js": "1.1.2",
     "rxjs": "7.8.1"

package/front_end/third_party/puppeteer/package/src/api/Browser.ts

@@ -3,7 +3,7 @@
  * Copyright 2017 Google Inc.
  * SPDX-License-Identifier: Apache-2.0
  */
-
+/// <reference types="node"  preserve="true"/>
 import type {ChildProcess} from 'child_process';
 
 import type {Protocol} from 'devtools-protocol';
@@ -273,7 +273,7 @@ export abstract class Browser extends EventEmitter<BrowserEvents> {
    * ```
    */
   abstract createBrowserContext(
-    options?: BrowserContextOptions
+    options?: BrowserContextOptions,
   ): Promise<BrowserContext>;
 
   /**
@@ -300,9 +300,8 @@ export abstract class Browser extends EventEmitter<BrowserEvents> {
    * You can find the debugger URL (`webSocketDebuggerUrl`) from
    * `http://HOST:PORT/json/version`.
    *
-   * See {@link
-   * https://chromedevtools.github.io/devtools-protocol/#how-do-i-access-the-browser-target
-   * | browser endpoint} for more information.
+   * See {@link https://chromedevtools.github.io/devtools-protocol/#how-do-i-access-the-browser-target | browser endpoint}
+   * for more information.
    *
    * @remarks The format is always `ws://HOST:PORT/devtools/browser/<id>`.
    */
@@ -340,24 +339,24 @@ export abstract class Browser extends EventEmitter<BrowserEvents> {
    * ```ts
    * await page.evaluate(() => window.open('https://www.example.com/'));
    * const newWindowTarget = await browser.waitForTarget(
-   *   target => target.url() === 'https://www.example.com/'
+   *   target => target.url() === 'https://www.example.com/',
    * );
    * ```
    */
   async waitForTarget(
     predicate: (x: Target) => boolean | Promise<boolean>,
-    options: WaitForTargetOptions = {}
+    options: WaitForTargetOptions = {},
   ): Promise<Target> {
     const {timeout: ms = 30000, signal} = options;
     return await firstValueFrom(
       merge(
         fromEmitterEvent(this, BrowserEvent.TargetCreated),
         fromEmitterEvent(this, BrowserEvent.TargetChanged),
-        from(this.targets())
+        from(this.targets()),
       ).pipe(
         filterAsync(predicate),
-        raceWith(fromAbortSignal(signal), timeout(ms))
-      )
+        raceWith(fromAbortSignal(signal), timeout(ms)),
+      ),
     );
   }
 
@@ -375,7 +374,7 @@ export abstract class Browser extends EventEmitter<BrowserEvents> {
     const contextPages = await Promise.all(
       this.browserContexts().map(context => {
         return context.pages();
-      })
+      }),
     );
     // Flatten array.
     return contextPages.reduce((acc, x) => {

package/front_end/third_party/puppeteer/package/src/api/BrowserContext.ts

@@ -154,21 +154,21 @@ export abstract class BrowserContext extends EventEmitter<BrowserContextEvents>
    * ```ts
    * await page.evaluate(() => window.open('https://www.example.com/'));
    * const newWindowTarget = await browserContext.waitForTarget(
-   *   target => target.url() === 'https://www.example.com/'
+   *   target => target.url() === 'https://www.example.com/',
    * );
    * ```
    */
   async waitForTarget(
     predicate: (x: Target) => boolean | Promise<boolean>,
-    options: WaitForTargetOptions = {}
+    options: WaitForTargetOptions = {},
   ): Promise<Target> {
     const {timeout: ms = 30000} = options;
     return await firstValueFrom(
       merge(
         fromEmitterEvent(this, BrowserContextEvent.TargetCreated),
         fromEmitterEvent(this, BrowserContextEvent.TargetChanged),
-        from(this.targets())
-      ).pipe(filterAsync(predicate), raceWith(timeout(ms)))
+        from(this.targets()),
+      ).pipe(filterAsync(predicate), raceWith(timeout(ms))),
     );
   }
 
@@ -202,7 +202,7 @@ export abstract class BrowserContext extends EventEmitter<BrowserContextEvents>
    */
   abstract overridePermissions(
     origin: string,
-    permissions: Permission[]
+    permissions: Permission[],
   ): Promise<void>;
 
   /**

package/front_end/third_party/puppeteer/package/src/api/CDPSession.ts

@@ -77,7 +77,7 @@ export interface CommandOptions {
  * const client = await page.createCDPSession();
  * await client.send('Animation.enable');
  * client.on('Animation.animationCreated', () =>
- *   console.log('Animation created!')
+ *   console.log('Animation created!'),
  * );
  * const response = await client.send('Animation.getPlaybackRate');
  * console.log('playback rate is ' + response.playbackRate);
@@ -110,7 +110,7 @@ export abstract class CDPSession extends EventEmitter<CDPSessionEvents> {
   abstract send<T extends keyof ProtocolMapping.Commands>(
     method: T,
     params?: ProtocolMapping.Commands[T]['paramsType'][0],
-    options?: CommandOptions
+    options?: CommandOptions,
   ): Promise<ProtocolMapping.Commands[T]['returnType']>;
 
   /**

package/front_end/third_party/puppeteer/package/src/api/Dialog.ts

@@ -47,7 +47,7 @@ export abstract class Dialog {
   constructor(
     type: Protocol.Page.DialogType,
     message: string,
-    defaultValue = ''
+    defaultValue = '',
   ) {
     this.#type = type;
     this.#message = message;

package/front_end/third_party/puppeteer/package/src/api/ElementHandle.ts

@@ -28,6 +28,7 @@ import type {
   KeyboardTypeOptions,
   KeyPressOptions,
   MouseClickOptions,
+  TouchHandle,
 } from './Input.js';
 import {JSHandle} from './JSHandle.js';
 import type {
@@ -119,7 +120,7 @@ export interface ElementScreenshotOptions extends ScreenshotOptions {
  */
 export function bindIsolatedHandle<This extends ElementHandle<Node>>(
   target: (this: This, ...args: any[]) => Promise<any>,
-  _: unknown
+  _: unknown,
 ): typeof target {
   return async function (...args) {
     // If the handle is already isolated, then we don't need to adopt it
@@ -152,7 +153,7 @@ export function bindIsolatedHandle<This extends ElementHandle<Node>>(
           if (item instanceof JSHandle) {
             result[index] = await this.realm.transferHandle(item);
           }
-        })
+        }),
       );
     }
     if (result instanceof Map) {
@@ -161,7 +162,7 @@ export function bindIsolatedHandle<This extends ElementHandle<Node>>(
           if (value instanceof JSHandle) {
             result.set(key, await this.realm.transferHandle(value));
           }
-        })
+        }),
       );
     }
     return result;
@@ -250,7 +251,7 @@ export abstract class ElementHandle<
   @throwIfDisposed()
   @bindIsolatedHandle
   override async getProperty<K extends keyof ElementType>(
-    propertyName: HandleOr<K>
+    propertyName: HandleOr<K>,
   ): Promise<HandleFor<ElementType[K]>> {
     return await this.handle.getProperty(propertyName);
   }
@@ -279,7 +280,7 @@ export abstract class ElementHandle<
   ): Promise<Awaited<ReturnType<Func>>> {
     pageFunction = withSourcePuppeteerURLIfNone(
       this.evaluate.name,
-      pageFunction
+      pageFunction,
     );
     return await this.handle.evaluate(pageFunction, ...args);
   }
@@ -299,7 +300,7 @@ export abstract class ElementHandle<
   ): Promise<HandleFor<Awaited<ReturnType<Func>>>> {
     pageFunction = withSourcePuppeteerURLIfNone(
       this.evaluateHandle.name,
-      pageFunction
+      pageFunction,
     );
     return await this.handle.evaluateHandle(pageFunction, ...args);
   }
@@ -370,13 +371,13 @@ export abstract class ElementHandle<
   @throwIfDisposed()
   @bindIsolatedHandle
   async $<Selector extends string>(
-    selector: Selector
+    selector: Selector,
   ): Promise<ElementHandle<NodeFor<Selector>> | null> {
     const {updatedSelector, QueryHandler} =
       getQueryHandlerAndSelector(selector);
     return (await QueryHandler.queryOne(
       this,
-      updatedSelector
+      updatedSelector,
     )) as ElementHandle<NodeFor<Selector>> | null;
   }
 
@@ -404,7 +405,7 @@ export abstract class ElementHandle<
   @throwIfDisposed()
   async $$<Selector extends string>(
     selector: Selector,
-    options?: QueryOptions
+    options?: QueryOptions,
   ): Promise<Array<ElementHandle<NodeFor<Selector>>>> {
     if (options?.isolate === false) {
       return await this.#$$impl(selector);
@@ -419,7 +420,7 @@ export abstract class ElementHandle<
    */
   @bindIsolatedHandle
   async #$$<Selector extends string>(
-    selector: Selector
+    selector: Selector,
   ): Promise<Array<ElementHandle<NodeFor<Selector>>>> {
     return await this.#$$impl(selector);
   }
@@ -430,12 +431,12 @@ export abstract class ElementHandle<
    * @internal
    */
   async #$$impl<Selector extends string>(
-    selector: Selector
+    selector: Selector,
   ): Promise<Array<ElementHandle<NodeFor<Selector>>>> {
     const {updatedSelector, QueryHandler} =
       getQueryHandlerAndSelector(selector);
     return await (AsyncIterableUtil.collect(
-      QueryHandler.queryAll(this, updatedSelector)
+      QueryHandler.queryAll(this, updatedSelector),
     ) as Promise<Array<ElementHandle<NodeFor<Selector>>>>);
   }
 
@@ -451,10 +452,10 @@ export abstract class ElementHandle<
    * ```ts
    * const tweetHandle = await page.$('.tweet');
    * expect(await tweetHandle.$eval('.like', node => node.innerText)).toBe(
-   *   '100'
+   *   '100',
    * );
    * expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe(
-   *   '10'
+   *   '10',
    * );
    * ```
    *
@@ -495,7 +496,7 @@ export abstract class ElementHandle<
     using elementHandle = await this.$(selector);
     if (!elementHandle) {
       throw new Error(
-        `Error: failed to find element matching selector "${selector}"`
+        `Error: failed to find element matching selector "${selector}"`,
       );
     }
     return await elementHandle.evaluate(pageFunction, ...args);
@@ -523,7 +524,7 @@ export abstract class ElementHandle<
    * ```ts
    * const feedHandle = await page.$('.feed');
    * expect(
-   *   await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText))
+   *   await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText)),
    * ).toEqual(['Hello!', 'Hi!']);
    * ```
    *
@@ -566,7 +567,7 @@ export abstract class ElementHandle<
       (_, ...elements) => {
         return elements;
       },
-      ...results
+      ...results,
     );
     const [result] = await Promise.all([
       elements.evaluate(pageFunction, ...args),
@@ -618,7 +619,7 @@ export abstract class ElementHandle<
   @bindIsolatedHandle
   async waitForSelector<Selector extends string>(
     selector: Selector,
-    options: WaitForSelectorOptions = {}
+    options: WaitForSelectorOptions = {},
   ): Promise<ElementHandle<NodeFor<Selector>> | null> {
     const {updatedSelector, QueryHandler, polling} =
       getQueryHandlerAndSelector(selector);
@@ -636,7 +637,7 @@ export abstract class ElementHandle<
       LazyArg.create(context => {
         return context.puppeteerUtil;
       }),
-      visibility
+      visibility,
     );
   }
 
@@ -684,7 +685,7 @@ export abstract class ElementHandle<
    *
    * ```ts
    * const element: ElementHandle<Element> = await page.$(
-   *   '.class-name-of-anchor'
+   *   '.class-name-of-anchor',
    * );
    * // DO NOT DISPOSE `element`, this will be always be the same handle.
    * const anchor: ElementHandle<HTMLAnchorElement> =
@@ -760,7 +761,7 @@ export abstract class ElementHandle<
   @bindIsolatedHandle
   async click(
     this: ElementHandle<Element>,
-    options: Readonly<ClickOptions> = {}
+    options: Readonly<ClickOptions> = {},
   ): Promise<void> {
     await this.scrollIntoViewIfNeeded();
     const {x, y} = await this.clickablePoint(options.offset);
@@ -777,7 +778,7 @@ export abstract class ElementHandle<
   @bindIsolatedHandle
   async drag(
     this: ElementHandle<Element>,
-    target: Point | ElementHandle<Element>
+    target: Point | ElementHandle<Element>,
   ): Promise<Protocol.Input.DragData | void> {
     await this.scrollIntoViewIfNeeded();
     const page = this.frame.page();
@@ -812,7 +813,7 @@ export abstract class ElementHandle<
   @bindIsolatedHandle
   async dragEnter(
     this: ElementHandle<Element>,
-    data: Protocol.Input.DragData = {items: [], dragOperationsMask: 1}
+    data: Protocol.Input.DragData = {items: [], dragOperationsMask: 1},
   ): Promise<void> {
     const page = this.frame.page();
     await this.scrollIntoViewIfNeeded();
@@ -827,7 +828,7 @@ export abstract class ElementHandle<
   @bindIsolatedHandle
   async dragOver(
     this: ElementHandle<Element>,
-    data: Protocol.Input.DragData = {items: [], dragOperationsMask: 1}
+    data: Protocol.Input.DragData = {items: [], dragOperationsMask: 1},
   ): Promise<void> {
     const page = this.frame.page();
     await this.scrollIntoViewIfNeeded();
@@ -840,7 +841,7 @@ export abstract class ElementHandle<
    */
   async drop(
     this: ElementHandle<Element>,
-    element: ElementHandle<Element>
+    element: ElementHandle<Element>,
   ): Promise<void>;
 
   /**
@@ -848,7 +849,7 @@ export abstract class ElementHandle<
    */
   async drop(
     this: ElementHandle<Element>,
-    data?: Protocol.Input.DragData
+    data?: Protocol.Input.DragData,
   ): Promise<void>;
 
   /**
@@ -861,7 +862,7 @@ export abstract class ElementHandle<
     dataOrElement: ElementHandle<Element> | Protocol.Input.DragData = {
       items: [],
       dragOperationsMask: 1,
-    }
+    },
   ): Promise<void> {
     const page = this.frame.page();
     if ('items' in dataOrElement) {
@@ -885,12 +886,12 @@ export abstract class ElementHandle<
   async dragAndDrop(
     this: ElementHandle<Element>,
     target: ElementHandle<Node>,
-    options?: {delay: number}
+    options?: {delay: number},
   ): Promise<void> {
     const page = this.frame.page();
     assert(
       page.isDragInterceptionEnabled(),
-      'Drag Interception is not enabled!'
+      'Drag Interception is not enabled!',
     );
     await this.scrollIntoViewIfNeeded();
     const startPoint = await this.clickablePoint();
@@ -924,7 +925,7 @@ export abstract class ElementHandle<
           value +
           '" of type "' +
           typeof value +
-          '"'
+          '"',
       );
     }
 
@@ -981,7 +982,7 @@ export abstract class ElementHandle<
    */
   abstract queryAXTree(
     name?: string,
-    role?: string
+    role?: string,
   ): AwaitableIterable<ElementHandle<Node>>;
 
   /**
@@ -997,19 +998,36 @@ export abstract class ElementHandle<
     await this.frame.page().touchscreen.tap(x, y);
   }
 
+  /**
+   * This method scrolls the element into view if needed, and then
+   * starts a touch in the center of the element.
+   * @returns A {@link TouchHandle} representing the touch that was started
+   */
   @throwIfDisposed()
   @bindIsolatedHandle
-  async touchStart(this: ElementHandle<Element>): Promise<void> {
+  async touchStart(this: ElementHandle<Element>): Promise<TouchHandle> {
     await this.scrollIntoViewIfNeeded();
     const {x, y} = await this.clickablePoint();
-    await this.frame.page().touchscreen.touchStart(x, y);
+    return await this.frame.page().touchscreen.touchStart(x, y);
   }
 
+  /**
+   * This method scrolls the element into view if needed, and then
+   * moves the touch to the center of the element.
+   * @param touch - An optional {@link TouchHandle}. If provided, this touch
+   * will be moved. If not provided, the first active touch will be moved.
+   */
   @throwIfDisposed()
   @bindIsolatedHandle
-  async touchMove(this: ElementHandle<Element>): Promise<void> {
+  async touchMove(
+    this: ElementHandle<Element>,
+    touch?: TouchHandle,
+  ): Promise<void> {
     await this.scrollIntoViewIfNeeded();
     const {x, y} = await this.clickablePoint();
+    if (touch) {
+      return await touch.move(x, y);
+    }
     await this.frame.page().touchscreen.touchMove(x, y);
   }
 
@@ -1063,7 +1081,7 @@ export abstract class ElementHandle<
   @bindIsolatedHandle
   async type(
     text: string,
-    options?: Readonly<KeyboardTypeOptions>
+    options?: Readonly<KeyboardTypeOptions>,
   ): Promise<void> {
     await this.focus();
     await this.frame.page().keyboard.type(text, options);
@@ -1087,7 +1105,7 @@ export abstract class ElementHandle<
   @bindIsolatedHandle
   async press(
     key: KeyInput,
-    options?: Readonly<KeyPressOptions>
+    options?: Readonly<KeyPressOptions>,
   ): Promise<void> {
     await this.focus();
     await this.frame.page().keyboard.press(key, options);
@@ -1266,7 +1284,7 @@ export abstract class ElementHandle<
 
       function transformQuadWithOffsets(
         quad: Quad,
-        offsets: {top: number; left: number; right: number; bottom: number}
+        offsets: {top: number; left: number; right: number; bottom: number},
       ): Quad {
         return [
           {
@@ -1352,14 +1370,14 @@ export abstract class ElementHandle<
    * If the element is detached from DOM, the method throws an error.
    */
   async screenshot(
-    options: Readonly<ScreenshotOptions> & {encoding: 'base64'}
+    options: Readonly<ScreenshotOptions> & {encoding: 'base64'},
   ): Promise<string>;
   async screenshot(options?: Readonly<ScreenshotOptions>): Promise<Uint8Array>;
   @throwIfDisposed()
   @bindIsolatedHandle
   async screenshot(
     this: ElementHandle<Element>,
-    options: Readonly<ElementScreenshotOptions> = {}
+    options: Readonly<ElementScreenshotOptions> = {},
   ): Promise<string | Uint8Array> {
     const {scrollIntoView = true, clip} = options;
 
@@ -1423,7 +1441,7 @@ export abstract class ElementHandle<
    * @internal
    */
   protected async scrollIntoViewIfNeeded(
-    this: ElementHandle<Element>
+    this: ElementHandle<Element>,
   ): Promise<void> {
     if (
       await this.isIntersectingViewport({
@@ -1449,7 +1467,7 @@ export abstract class ElementHandle<
     this: ElementHandle<Element>,
     options: {
       threshold?: number;
-    } = {}
+    } = {},
   ): Promise<boolean> {
     await this.assertConnectedElement();
     // eslint-disable-next-line rulesdir/use-using -- Returns `this`.
@@ -1466,7 +1484,7 @@ export abstract class ElementHandle<
         });
         return threshold === 1 ? visibleRatio === 1 : visibleRatio > threshold;
       },
-      options.threshold ?? 0
+      options.threshold ?? 0,
     );
   }
 
@@ -1492,7 +1510,7 @@ export abstract class ElementHandle<
    * etc.).
    */
   async #asSVGElementHandle(
-    this: ElementHandle<Element>
+    this: ElementHandle<Element>,
   ): Promise<ElementHandle<SVGElement> | null> {
     if (
       await this.evaluate(element => {
@@ -1506,7 +1524,7 @@ export abstract class ElementHandle<
   }
 
   async #getOwnerSVGElement(
-    this: ElementHandle<SVGElement>
+    this: ElementHandle<SVGElement>,
   ): Promise<ElementHandle<SVGSVGElement>> {
     // SVGSVGElement.ownerSVGElement === null.
     return await this.evaluateHandle(element => {
@@ -1562,18 +1580,18 @@ export interface AutofillData {
 function intersectBoundingBox(
   box: BoundingBox,
   width: number,
-  height: number
+  height: number,
 ): void {
   box.width = Math.max(
     box.x >= 0
       ? Math.min(width - box.x, box.width)
       : Math.min(width, box.width + box.x),
-    0
+    0,
   );
   box.height = Math.max(
     box.y >= 0
       ? Math.min(height - box.y, box.height)
       : Math.min(height, box.height + box.y),
-    0
+    0,
   );
 }