puppeteer/website/versioned_docs/version-21.2.1/api/puppeteer.page.waitforframe.md

sidebar_label
Page.waitForFrame

Page.waitForFrame() method

Waits for a frame matching the given conditions to appear.

Signature:

class Page {
  waitForFrame(
    urlOrPredicate: string | ((frame: Frame) => Awaitable<boolean>),
    options?: WaitTimeoutOptions
  ): Promise<Frame>;
}

Parameters

Parameter	Type	Description
urlOrPredicate	string | ((frame: Frame) => Awaitable<boolean>)
options	WaitTimeoutOptions	(Optional)

Returns:

Promise<Frame>

Example

const frame = await page.waitForFrame(async frame => {
  return frame.name() === 'Test';
});