chrome-devtools-frontend 1.0.1386602 → 1.0.1402249

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

@@ -15,6 +15,7 @@ import {
   raceWith,
 } from '../../third_party/rxjs/rxjs.js';
 import type {ProtocolType} from '../common/ConnectOptions.js';
+import type {Cookie} from '../common/Cookie.js';
 import type {DownloadBehavior} from '../common/DownloadBehavior.js';
 import {EventEmitter, type EventType} from '../common/EventEmitter.js';
 import {
@@ -424,6 +425,42 @@ export abstract class Browser extends EventEmitter<BrowserEvents> {
    */
   abstract disconnect(): Promise<void>;
 
+  /**
+   * Returns all cookies in the default {@link BrowserContext}.
+   *
+   * @remarks
+   *
+   * Shortcut for
+   * {@link BrowserContext.cookies | browser.defaultBrowserContext().cookies()}.
+   */
+  async cookies(): Promise<Cookie[]> {
+    return await this.defaultBrowserContext().cookies();
+  }
+
+  /**
+   * Sets cookies in the default {@link BrowserContext}.
+   *
+   * @remarks
+   *
+   * Shortcut for
+   * {@link BrowserContext.setCookie | browser.defaultBrowserContext().setCookie()}.
+   */
+  async setCookie(...cookies: Cookie[]): Promise<void> {
+    return await this.defaultBrowserContext().setCookie(...cookies);
+  }
+
+  /**
+   * Removes cookies from the default {@link BrowserContext}.
+   *
+   * @remarks
+   *
+   * Shortcut for
+   * {@link BrowserContext.deleteCookie | browser.defaultBrowserContext().deleteCookie()}.
+   */
+  async deleteCookie(...cookies: Cookie[]): Promise<void> {
+    return await this.defaultBrowserContext().deleteCookie(...cookies);
+  }
+
   /**
    * Whether Puppeteer is connected to this {@link Browser | browser}.
    *

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

@@ -10,6 +10,7 @@ import {
   merge,
   raceWith,
 } from '../../third_party/rxjs/rxjs.js';
+import type {Cookie, CookieData} from '../common/Cookie.js';
 import {EventEmitter, type EventType} from '../common/EventEmitter.js';
 import {
   debugError,
@@ -243,6 +244,31 @@ export abstract class BrowserContext extends EventEmitter<BrowserContextEvents>
    */
   abstract close(): Promise<void>;
 
+  /**
+   * Gets all cookies in the browser context.
+   */
+  abstract cookies(): Promise<Cookie[]>;
+
+  /**
+   * Sets a cookie in the browser context.
+   */
+  abstract setCookie(...cookies: CookieData[]): Promise<void>;
+
+  /**
+   * Removes cookie in the browser context
+   * @param cookies - {@link Cookie | cookie} to remove
+   */
+  async deleteCookie(...cookies: Cookie[]): Promise<void> {
+    return await this.setCookie(
+      ...cookies.map(cookie => {
+        return {
+          ...cookie,
+          expires: 1,
+        };
+      }),
+    );
+  }
+
   /**
    * Whether this {@link BrowserContext | browser context} is closed.
    */

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

@@ -1561,6 +1561,12 @@ export abstract class ElementHandle<
    * ```
    */
   abstract autofill(data: AutofillData): Promise<void>;
+
+  /**
+   * When connected using Chrome DevTools Protocol, it returns a
+   * DOM.BackendNodeId for the element.
+   */
+  abstract backendNodeId(): Promise<number>;
 }
 
 /**

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

@@ -1397,19 +1397,32 @@ export abstract class Page extends EventEmitter<PageEvents> {
   }
 
   /**
-   * If no URLs are specified, this method returns cookies for the current page
-   * URL. If URLs are specified, only cookies for those URLs are returned.
+   * If no URLs are specified, this method returns cookies for the
+   * current page URL. If URLs are specified, only cookies for those
+   * URLs are returned.
+   *
+   * @deprecated Page-level cookie API is deprecated. Use
+   * {@link Browser.cookies} or {@link BrowserContext.cookies} instead.
    */
   abstract cookies(...urls: string[]): Promise<Cookie[]>;
 
+  /**
+   * @deprecated Page-level cookie API is deprecated. Use
+   * {@link Browser.deleteCookie} or {@link BrowserContext.deleteCookie}
+   * instead.
+   */
   abstract deleteCookie(...cookies: DeleteCookiesRequest[]): Promise<void>;
 
   /**
    * @example
    *
-   * ```ts
+   *```ts
    * await page.setCookie(cookieObject1, cookieObject2);
-   * ```
+   *```
+   *
+   * @deprecated Page-level cookie API is deprecated. Use
+   * {@link Browser.setCookie} or {@link BrowserContext.setCookie}
+   * instead.
    */
   abstract setCookie(...cookies: CookieParam[]): Promise<void>;
 
@@ -2115,6 +2128,9 @@ export abstract class Page extends EventEmitter<PageEvents> {
    *   await page.emulateVisionDeficiency('blurredVision');
    *   await page.screenshot({path: 'blurred-vision.png'});
    *
+   *   await page.emulateVisionDeficiency('reducedContrast');
+   *   await page.screenshot({path: 'reduced-contrast.png'});
+   *
    *   await browser.close();
    * })();
    * ```
@@ -2159,8 +2175,8 @@ export abstract class Page extends EventEmitter<PageEvents> {
    *
    * This is either the viewport set with the previous {@link Page.setViewport}
    * call or the default viewport set via
-   * {@link BrowserConnectOptions.defaultViewport |
-   * BrowserConnectOptions.defaultViewport}.
+   * {@link ConnectOptions.defaultViewport |
+   * ConnectOptions.defaultViewport}.
    */
   abstract viewport(): Viewport | null;
 
@@ -2498,8 +2514,6 @@ export abstract class Page extends EventEmitter<PageEvents> {
   ): Promise<Uint8Array | string> {
     using _guard = await this.browserContext().startScreenshot();
 
-    await this.bringToFront();
-
     const options = {
       ...userOptions,
       clip: userOptions.clip

package/front_end/third_party/puppeteer/package/src/bidi/BrowserConnector.ts

@@ -7,10 +7,7 @@
 import type {BrowserCloseCallback} from '../api/Browser.js';
 import {Connection} from '../cdp/Connection.js';
 import type {ConnectionTransport} from '../common/ConnectionTransport.js';
-import type {
-  BrowserConnectOptions,
-  ConnectOptions,
-} from '../common/ConnectOptions.js';
+import type {ConnectOptions} from '../common/ConnectOptions.js';
 import {ProtocolError, UnsupportedOperation} from '../common/Errors.js';
 import {debugError, DEFAULT_VIEWPORT} from '../common/util.js';
 
@@ -28,7 +25,7 @@ import type {BidiConnection} from './Connection.js';
 export async function _connectToBiDiBrowser(
   connectionTransport: ConnectionTransport,
   url: string,
-  options: BrowserConnectOptions & ConnectOptions,
+  options: ConnectOptions,
 ): Promise<BidiBrowser> {
   const {acceptInsecureCerts = false, defaultViewport = DEFAULT_VIEWPORT} =
     options;
@@ -58,7 +55,7 @@ export async function _connectToBiDiBrowser(
 async function getBiDiConnection(
   connectionTransport: ConnectionTransport,
   url: string,
-  options: BrowserConnectOptions,
+  options: ConnectOptions,
 ): Promise<{
   cdpConnection?: Connection;
   bidiConnection: BidiConnection;
@@ -100,6 +97,7 @@ async function getBiDiConnection(
     connectionTransport,
     slowMo,
     protocolTimeout,
+    /* rawErrors= */ true,
   );
 
   const version = await cdpConnection.send('Browser.getVersion');

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

@@ -12,6 +12,7 @@ import type {BrowserContextEvents} from '../api/BrowserContext.js';
 import {BrowserContext, BrowserContextEvent} from '../api/BrowserContext.js';
 import {PageEvent, type Page} from '../api/Page.js';
 import type {Target} from '../api/Target.js';
+import type {Cookie, CookieData} from '../common/Cookie.js';
 import {EventEmitter} from '../common/EventEmitter.js';
 import {debugError} from '../common/util.js';
 import type {Viewport} from '../common/Viewport.js';
@@ -22,7 +23,14 @@ import type {BidiBrowser} from './Browser.js';
 import type {BrowsingContext} from './core/BrowsingContext.js';
 import {UserContext} from './core/UserContext.js';
 import type {BidiFrame} from './Frame.js';
-import {BidiPage} from './Page.js';
+import {
+  BidiPage,
+  bidiToPuppeteerCookie,
+  cdpSpecificCookiePropertiesFromPuppeteerToBidi,
+  convertCookiesExpiryCdpToBiDi,
+  convertCookiesPartitionKeyFromPuppeteerToBiDi,
+  convertCookiesSameSiteCdpToBiDi,
+} from './Page.js';
 import {BidiWorkerTarget} from './Target.js';
 import {BidiFrameTarget, BidiPageTarget} from './Target.js';
 import type {BidiWebWorker} from './WebWorker.js';
@@ -88,17 +96,15 @@ export class BidiBrowserContext extends BrowserContext {
 
       // We need to wait for the DOMContentLoaded as the
       // browsingContext still may be navigating from the about:blank
-      browsingContext.once('DOMContentLoaded', () => {
-        if (browsingContext.originalOpener) {
-          for (const context of this.userContext.browsingContexts) {
-            if (context.id === browsingContext.originalOpener) {
-              this.#pages
-                .get(context)!
-                .trustedEmitter.emit(PageEvent.Popup, page);
-            }
+      if (browsingContext.originalOpener) {
+        for (const context of this.userContext.browsingContexts) {
+          if (context.id === browsingContext.originalOpener) {
+            this.#pages
+              .get(context)!
+              .trustedEmitter.emit(PageEvent.Popup, page);
           }
         }
-      });
+      }
     });
     this.userContext.on('closed', () => {
       this.trustedEmitter.removeAllListeners();
@@ -281,4 +287,45 @@ export class BidiBrowserContext extends BrowserContext {
     }
     return this.userContext.id;
   }
+
+  override async cookies(): Promise<Cookie[]> {
+    const cookies = await this.userContext.getCookies();
+    return cookies.map(cookie => {
+      return bidiToPuppeteerCookie(cookie, true);
+    });
+  }
+
+  override async setCookie(...cookies: CookieData[]): Promise<void> {
+    await Promise.all(
+      cookies.map(async cookie => {
+        const bidiCookie: Bidi.Storage.PartialCookie = {
+          domain: cookie.domain,
+          name: cookie.name,
+          value: {
+            type: 'string',
+            value: cookie.value,
+          },
+          ...(cookie.path !== undefined ? {path: cookie.path} : {}),
+          ...(cookie.httpOnly !== undefined ? {httpOnly: cookie.httpOnly} : {}),
+          ...(cookie.secure !== undefined ? {secure: cookie.secure} : {}),
+          ...(cookie.sameSite !== undefined
+            ? {sameSite: convertCookiesSameSiteCdpToBiDi(cookie.sameSite)}
+            : {}),
+          ...{expiry: convertCookiesExpiryCdpToBiDi(cookie.expires)},
+          // Chrome-specific properties.
+          ...cdpSpecificCookiePropertiesFromPuppeteerToBidi(
+            cookie,
+            'sameParty',
+            'sourceScheme',
+            'priority',
+            'url',
+          ),
+        };
+        return await this.userContext.setCookie(
+          bidiCookie,
+          convertCookiesPartitionKeyFromPuppeteerToBiDi(cookie.partitionKey),
+        );
+      }),
+    );
+  }
 }

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

@@ -11,6 +11,7 @@ import {
   ElementHandle,
   type AutofillData,
 } from '../api/ElementHandle.js';
+import {UnsupportedOperation} from '../common/Errors.js';
 import type {AwaitableIterable} from '../common/types.js';
 import {environment} from '../environment.js';
 import {AsyncIterableUtil} from '../util/AsyncIterableUtil.js';
@@ -26,6 +27,8 @@ import type {BidiFrameRealm} from './Realm.js';
 export class BidiElementHandle<
   ElementType extends Node = Element,
 > extends ElementHandle<ElementType> {
+  #backendNodeId?: number;
+
   static from<ElementType extends Node = Element>(
     value: Bidi.Script.RemoteValue,
     realm: BidiFrameRealm,
@@ -132,4 +135,18 @@ export class BidiElementHandle<
       return Promise.resolve(BidiElementHandle.from(node, this.realm));
     });
   }
+
+  override async backendNodeId(): Promise<number> {
+    if (!this.frame.page().browser().cdpSupported) {
+      throw new UnsupportedOperation();
+    }
+    if (this.#backendNodeId) {
+      return this.#backendNodeId;
+    }
+    const {node} = await this.frame.client.send('DOM.describeNode', {
+      objectId: this.handle.id,
+    });
+    this.#backendNodeId = node.backendNodeId;
+    return this.#backendNodeId;
+  }
 }

package/front_end/third_party/puppeteer/package/src/bidi/Frame.ts

@@ -16,6 +16,7 @@ import {
   firstValueFrom,
   map,
   of,
+  race,
   raceWith,
   switchMap,
 } from '../../third_party/rxjs/rxjs.js';
@@ -114,7 +115,7 @@ export class BidiFrame extends Frame {
         this,
       ),
     };
-    this.accessibility = new Accessibility(this.realms.default);
+    this.accessibility = new Accessibility(this.realms.default, this._id);
   }
 
   #initialize(): void {
@@ -373,10 +374,20 @@ export class BidiFrame extends Frame {
     });
     return await firstValueFrom(
       combineLatest([
-        fromEmitterEvent(this.browsingContext, 'navigation')
+        race(
+          fromEmitterEvent(this.browsingContext, 'navigation'),
+          fromEmitterEvent(this.browsingContext, 'historyUpdated').pipe(
+            map(() => {
+              return {navigation: null};
+            }),
+          ),
+        )
           .pipe(first())
           .pipe(
             switchMap(({navigation}) => {
+              if (navigation === null) {
+                return of(null);
+              }
               return this.#waitForLoad$(options).pipe(
                 delayWhen(() => {
                   if (frames.length === 0) {
@@ -397,7 +408,10 @@ export class BidiFrame extends Frame {
                   if (navigation.request) {
                     function requestFinished$(
                       request: Request,
-                    ): Observable<Navigation> {
+                    ): Observable<Navigation | null> {
+                      if (navigation === null) {
+                        return of(null);
+                      }
                       // Reduces flakiness if the response events arrive after
                       // the load event.
                       // Usually, the response or error is already there at this point.
@@ -428,6 +442,9 @@ export class BidiFrame extends Frame {
         this.#waitForNetworkIdle$(options),
       ]).pipe(
         map(([navigation]) => {
+          if (!navigation) {
+            return null;
+          }
           const request = navigation.request;
           if (!request) {
             return null;

package/front_end/third_party/puppeteer/package/src/bidi/HTTPRequest.ts

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type * as Bidi from 'chromium-bidi/lib/cjs/protocol/protocol.js';
+import type {Protocol} from 'devtools-protocol';
 
 import type {CDPSession} from '../api/CDPSession.js';
 import type {
@@ -184,8 +185,11 @@ export class BidiHTTPRequest extends HTTPRequest {
     return this.#request.navigation !== undefined;
   }
 
-  override initiator(): Bidi.Network.Initiator {
-    return this.#request.initiator;
+  override initiator(): Protocol.Network.Initiator | undefined {
+    return {
+      ...this.#request.initiator,
+      type: this.#request.initiator?.type ?? 'other',
+    };
   }
 
   override redirectChain(): BidiHTTPRequest[] {

package/front_end/third_party/puppeteer/package/src/bidi/Page.ts

@@ -32,6 +32,7 @@ import type {
 } from '../cdp/NetworkManager.js';
 import {Tracing} from '../cdp/Tracing.js';
 import type {
+  CookiePartitionKey,
   Cookie,
   CookieParam,
   CookieSameSite,
@@ -734,6 +735,12 @@ export class BidiPage extends Page {
         !String.prototype.startsWith.call(cookieUrl || '', 'data:'),
         `Data URL page can not have cookie "${cookie.name}"`,
       );
+      // TODO: Support Chrome cookie partition keys
+      assert(
+        cookie.partitionKey === undefined ||
+          typeof cookie.partitionKey === 'string',
+        'BiDi only allows domain partition keys',
+      );
 
       const normalizedUrl = URL.canParse(cookieUrl)
         ? new URL(cookieUrl)
@@ -758,7 +765,7 @@ export class BidiPage extends Page {
         ...(cookie.sameSite !== undefined
           ? {sameSite: convertCookiesSameSiteCdpToBiDi(cookie.sameSite)}
           : {}),
-        ...(cookie.expires !== undefined ? {expiry: cookie.expires} : {}),
+        ...{expiry: convertCookiesExpiryCdpToBiDi(cookie.expires)},
         // Chrome-specific properties.
         ...cdpSpecificCookiePropertiesFromPuppeteerToBidi(
           cookie,
@@ -922,14 +929,25 @@ function testUrlMatchCookie(cookie: Cookie, url: URL): boolean {
   return testUrlMatchCookiePath(cookie, normalizedUrl);
 }
 
-function bidiToPuppeteerCookie(bidiCookie: Bidi.Network.Cookie): Cookie {
+export function bidiToPuppeteerCookie(
+  bidiCookie: Bidi.Network.Cookie,
+  returnCompositePartitionKey = false,
+): Cookie {
   const partitionKey = bidiCookie[CDP_SPECIFIC_PREFIX + 'partitionKey'];
 
-  function getParitionKey(): {partitionKey?: string} {
+  function getParitionKey(): {partitionKey?: Cookie['partitionKey']} {
     if (typeof partitionKey === 'string') {
       return {partitionKey};
     }
     if (typeof partitionKey === 'object' && partitionKey !== null) {
+      if (returnCompositePartitionKey) {
+        return {
+          partitionKey: {
+            sourceOrigin: partitionKey.topLevelSite,
+            hasCrossSiteAncestor: partitionKey.hasCrossSiteAncestor ?? false,
+          },
+        };
+      }
       return {
         // TODO: a breaking change in Puppeteer is required to change
         // partitionKey type and report the composite partition key.
@@ -985,7 +1003,7 @@ function cdpSpecificCookiePropertiesFromBidiToPuppeteer(
  * Gets CDP-specific properties from the cookie, adds CDP-specific prefixes and returns
  * them as a new object which can be used in BiDi.
  */
-function cdpSpecificCookiePropertiesFromPuppeteerToBidi(
+export function cdpSpecificCookiePropertiesFromPuppeteerToBidi(
   cookieParam: CookieParam,
   ...propertyNames: Array<keyof CookieParam>
 ): Record<string, unknown> {
@@ -1004,7 +1022,7 @@ function convertCookiesSameSiteBiDiToCdp(
   return sameSite === 'strict' ? 'Strict' : sameSite === 'lax' ? 'Lax' : 'None';
 }
 
-function convertCookiesSameSiteCdpToBiDi(
+export function convertCookiesSameSiteCdpToBiDi(
   sameSite: CookieSameSite | undefined,
 ): Bidi.Network.SameSite {
   return sameSite === 'Strict'
@@ -1013,3 +1031,23 @@ function convertCookiesSameSiteCdpToBiDi(
       ? Bidi.Network.SameSite.Lax
       : Bidi.Network.SameSite.None;
 }
+
+export function convertCookiesExpiryCdpToBiDi(
+  expiry: number | undefined,
+): number | undefined {
+  return [undefined, -1].includes(expiry) ? undefined : expiry;
+}
+
+export function convertCookiesPartitionKeyFromPuppeteerToBiDi(
+  partitionKey: CookiePartitionKey | string | undefined,
+): string | undefined {
+  if (partitionKey === undefined || typeof partitionKey === 'string') {
+    return partitionKey;
+  }
+  if (partitionKey.hasCrossSiteAncestor) {
+    throw new UnsupportedOperation(
+      'WebDriver BiDi does not support `hasCrossSiteAncestor` yet.',
+    );
+  }
+  return partitionKey.sourceOrigin;
+}

package/front_end/third_party/puppeteer/package/src/bidi/core/BrowsingContext.ts

@@ -108,6 +108,8 @@ export class BrowsingContext extends EventEmitter<{
     /** The prompt that was opened. */
     userPrompt: UserPrompt;
   };
+  /** Emitted whenever the frame history is updated. */
+  historyUpdated: void;
   /** Emitted whenever the frame emits `DOMContentLoaded` */
   DOMContentLoaded: void;
   /** Emitted whenever the frame emits `load` */
@@ -210,6 +212,14 @@ export class BrowsingContext extends EventEmitter<{
       this.dispose('Browsing context already closed.');
     });
 
+    sessionEmitter.on('browsingContext.historyUpdated', info => {
+      if (info.context !== this.id) {
+        return;
+      }
+      this.#url = info.url;
+      this.emit('historyUpdated', undefined);
+    });
+
     sessionEmitter.on('browsingContext.domContentLoaded', info => {
       if (info.context !== this.id) {
         return;

package/front_end/third_party/puppeteer/package/src/bidi/core/Request.ts

@@ -133,7 +133,7 @@ export class Request extends EventEmitter<{
   get id(): string {
     return this.#event.request.request;
   }
-  get initiator(): Bidi.Network.Initiator {
+  get initiator(): Bidi.Network.Initiator | undefined {
     return this.#event.initiator;
   }
   get method(): string {

package/front_end/third_party/puppeteer/package/src/cdp/Accessibility.ts

@@ -99,6 +99,13 @@ export interface SnapshotOptions {
    * @defaultValue `true`
    */
   interestingOnly?: boolean;
+  /**
+   * If true, gets accessibility trees for each of the iframes in the frame
+   * subtree.
+   *
+   * @defaultValue `false`
+   */
+  includeIframes?: boolean;
   /**
    * Root node to get the accessibility tree for
    * @defaultValue The root node of the entire page.
@@ -130,12 +137,14 @@ export interface SnapshotOptions {
  */
 export class Accessibility {
   #realm: Realm;
+  #frameId: string;
 
   /**
    * @internal
    */
-  constructor(realm: Realm) {
+  constructor(realm: Realm, frameId = '') {
     this.#realm = realm;
+    this.#frameId = frameId;
   }
 
   /**
@@ -180,9 +189,16 @@ export class Accessibility {
   public async snapshot(
     options: SnapshotOptions = {},
   ): Promise<SerializedAXNode | null> {
-    const {interestingOnly = true, root = null} = options;
+    const {
+      interestingOnly = true,
+      root = null,
+      includeIframes = false,
+    } = options;
     const {nodes} = await this.#realm.environment.client.send(
       'Accessibility.getFullAXTree',
+      {
+        frameId: this.#frameId,
+      },
     );
     let backendNodeId: number | undefined;
     if (root) {
@@ -195,15 +211,44 @@ export class Accessibility {
       backendNodeId = node.backendNodeId;
     }
     const defaultRoot = AXNode.createTree(this.#realm, nodes);
+    const populateIframes = async (root: AXNode): Promise<void> => {
+      if (root.payload.role?.value === 'Iframe') {
+        if (!root.payload.backendDOMNodeId) {
+          return;
+        }
+        using handle = (await this.#realm.adoptBackendNode(
+          root.payload.backendDOMNodeId,
+        )) as ElementHandle<Element>;
+        if (!handle || !('contentFrame' in handle)) {
+          return;
+        }
+        const frame = await handle.contentFrame();
+        if (!frame) {
+          return;
+        }
+        const iframeSnapshot = await frame.accessibility.snapshot(options);
+        root.iframeSnapshot = iframeSnapshot ?? undefined;
+      }
+      for (const child of root.children) {
+        await populateIframes(child);
+      }
+    };
+
     let needle: AXNode | null = defaultRoot;
     if (!defaultRoot) {
       return null;
     }
+
+    if (includeIframes) {
+      await populateIframes(defaultRoot);
+    }
+
     if (backendNodeId) {
       needle = defaultRoot.find(node => {
         return node.payload.backendDOMNodeId === backendNodeId;
       });
     }
+
     if (!needle) {
       return null;
     }
@@ -237,6 +282,12 @@ export class Accessibility {
     if (children.length) {
       serializedNode.children = children;
     }
+    if (node.iframeSnapshot) {
+      if (!serializedNode.children) {
+        serializedNode.children = [];
+      }
+      serializedNode.children.push(node.iframeSnapshot);
+    }
     return [serializedNode];
   }
 
@@ -245,7 +296,7 @@ export class Accessibility {
     node: AXNode,
     insideControl: boolean,
   ): void {
-    if (node.isInteresting(insideControl)) {
+    if (node.isInteresting(insideControl) || node.iframeSnapshot) {
       collection.add(node);
     }
     if (node.isLeafNode()) {
@@ -261,6 +312,7 @@ export class Accessibility {
 class AXNode {
   public payload: Protocol.Accessibility.AXNode;
   public children: AXNode[] = [];
+  public iframeSnapshot?: SerializedAXNode;
 
   #richlyEditable = false;
   #editable = false;