1.5 KiB
1.5 KiB
Home > puppeteer > Frame > waitForNavigation
Frame.waitForNavigation() method
Signature:
waitForNavigation(options?: {
timeout?: number;
waitUntil?: PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[];
}): Promise<HTTPResponse | null>;
Parameters
| Parameter | Type | Description |
|---|---|---|
| options | { timeout?: number; waitUntil?: PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[]; } | options to configure when the navigation is consided finished. |
Returns:
Promise<HTTPResponse | null>
a promise that resolves when the frame navigates to a new URL.
Remarks
This resolves when the frame navigates to a new URL. It is useful for when you run code which will indirectly cause the frame to navigate. Consider this 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'),
]);
Usage of the History API to change the URL is considered a navigation.