puppeteer/website/versioned_docs/version-21.6.0/api/puppeteer.page.waitforrequest.md

sidebar_label
Page.waitForRequest

Page.waitForRequest() method

Signature:

class Page {
  abstract waitForRequest(
    urlOrPredicate: string | ((req: HTTPRequest) => boolean | Promise<boolean>),
    options?: {
      timeout?: number;
    }
  ): Promise<HTTPRequest>;
}

Parameters

Parameter	Type	Description
urlOrPredicate	string | ((req: HTTPRequest) => boolean | Promise<boolean>)	A URL or predicate to wait for
options	{ timeout?: number; }	(Optional) Optional waiting parameters

Returns:

Promise<HTTPRequest>

Promise which resolves to the matched request

Remarks

Optional Waiting Parameters 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 firstRequest = await page.waitForRequest('https://example.com/resource');
const finalRequest = await page.waitForRequest(
  request => request.url() === 'https://example.com'
);
return finalRequest.response()?.ok();