Skip to main content
Version: 22.13.1

Frame.waitForNavigation() method

Waits for the frame to navigate. It is useful for when you run code which will indirectly cause the frame to navigate.

Usage of the History API to change the URL is considered a navigation.

Signature:

class Frame {
abstract waitForNavigation(
options?: WaitForOptions
): Promise<HTTPResponse | null>;
}

Parameters

Parameter

Type

Description

options

WaitForOptions

(Optional) Options to configure waiting behavior.

Returns:

Promise<HTTPResponse | null>

A promise which resolves to the main resource response.

Example

const [response] = await Promise.all([
// The navigation promise resolves after navigation has finished
frame.waitForNavigation(),
// Clicking the link will indirectly cause a navigation
frame.click('a.my-link'),
]);