Skip to main content
Version: 20.5.0

Page.waitForFrame() method

Signature:

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

Parameters

ParameterTypeDescription
urlOrPredicatestring | ((frame: Frame) => boolean | Promise<boolean>)A URL or predicate to wait for.
options{ timeout?: number; }(Optional) Optional waiting parameters

Returns:

Promise<Frame>

Promise which resolves to the matched frame.

Remarks

Optional Parameter have:

  • timeout: Maximum wait time in milliseconds, defaults to 30 seconds, pass 0 to disable the timeout. The default value can be changed by using the Page.setDefaultTimeout() method.

Example

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