Class Page

packages/web-integration/src/puppeteer/base-page.ts:94–1241

}

export class Page<
  AgentType extends 'puppeteer' | 'playwright',
  InterfaceType extends PuppeteerPage | PlaywrightPage,
> implements AbstractInterface
{
  underlyingPage: InterfaceType;
  protected waitForNavigationTimeout: number;
  protected waitForNetworkIdleTimeout: number;
  private viewportSize?: Size;
  private onBeforeInvokeAction?: AbstractInterface['beforeInvokeAction'];
  private onAfterInvokeAction?: AbstractInterface['afterInvokeAction'];
  private customActions?: DeviceAction<any>[];
  private enableTouchEventsInActionSpace: boolean;
  private keyboardTypeDelay: number | undefined;
  private puppeteerFileChooserSession?: CDPSession;
  private puppeteerFileChooserHandler?: (
    event: Protocol.Page.FileChooserOpenedEvent,
  ) => Promise<void>;
  private playwrightNetworkIdleWarningShown = false;
  private activeMjpegStream?: {
    token: symbol;
    onFrame: MjpegStreamOptions['onFrame'];
    onError?: MjpegStreamOptions['onError'];
  };
  private visualUpdateFlushInFlight: Promise<void> | null = null;
  private visualUpdateFlushQueued = false;
  interfaceType: AgentType;

  actionSpace(): DeviceAction[] {
    const defaultActions = commonWebActionsForWebPage(
      this,
      this.enableTouchEventsInActionSpace,
    );
    const customActions = this.customActions || [];
    return [...defaultActions, ...customActions];
  }

  private async evaluate<R>(
    pageFunction: string | ((...args: any[]) => R | Promise<R>),
    arg?: any,
  ): Promise<R> {
    let result: R;
    debugPage('evaluate function begin');
    if (this.interfaceType === 'puppeteer') {
      result = await (this.underlyingPage as PuppeteerPage).evaluate(
        pageFunction,
        arg,
      );
    } else {
      result = await (this.underlyingPage as PlaywrightPage).evaluate(
        pageFunction,
        arg,
      );
    }
    debugPage('evaluate function end');
    return result;
  }