Files
puppeteer/docs/api/puppeteer.page.waitforframe.md
dependabot[bot]GitHubdependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>Nikolay Vitkov
4afe06b61d chore(deps-dev): Bump the dev-dependencies group with 14 updates (#13982)
Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Nikolay Vitkov <[email protected]>
2025-07-02 08:16:05 +00:00

1.1 KiB

sidebar_label
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 => {
  const frameElement = await frame.frameElement();
  if (!frameElement) {
    return false;
  }
  const name = await frameElement.evaluate(el => el.getAttribute('name'));
  return name === 'test';
});