Skip to main content
Page waiting methods for the Playwright driver.

​
waitForSelector

Wait for a selector to appear in the DOM.
Deprecated: Use locator-based methods or web assertions instead.
Upstream docs
​
selector
string
required
​
options
PlaywrightWaitForSelectorOptions
​
result
RemotePlaywrightElementHandle | null
Return value
await page.waitForSelector('...');

​
waitForTimeout

Wait for the specified timeout.
Discouraged: Use time-based assertions or auto-waiting instead.
Upstream docs
​
timeout
number
required
await page.waitForTimeout(0);

​
waitForFunction

Wait for a function to return a truthy value.
Note: Returns a serialized handle reference. Full JSHandle support not yet available.
Upstream docs
​
pageFunction
string
required
​
arg
unknown
​
options
PlaywrightWaitForFunctionOptions
​
result
unknown
Return value
await page.waitForFunction('...');

​
waitForEvent

Wait for a specific event to fire. Upstream docs
​
event
K
required
​
optionsOrPredicate
{ predicate?: (event: PageEvents[K]) => boolean | Promise<boolean>; timeout?: number } | ((event: PageEvents[K]) => boolean | Promise<boolean>)
​
result
PageEvents[K]
Return value
await page.waitForEvent(/* K */);

​
waitForRequest

Wait for a specific request. Upstream docs
​
urlOrPredicate
string | RegExp | ((request: PlaywrightRequest) => boolean | Promise<boolean>)
required
​
options
{ timeout?: number }
​
result
PlaywrightRequest
Return value
await page.waitForRequest(/* string | RegExp | ((request: PlaywrightRequest) => boolean | Promise<boolean>) */);

​
waitForResponse

Wait for a specific response. Upstream docs
​
urlOrPredicate
string | RegExp | ((response: PlaywrightResponse) => boolean | Promise<boolean>)
required
​
options
{ timeout?: number }
​
result
PlaywrightResponse
Return value
await page.waitForResponse(/* string | RegExp | ((response: PlaywrightResponse) => boolean | Promise<boolean>) */);