Skip to main content
Frame navigation methods for the Playwright driver.

​
goto

Returns the main resource response.
Navigates the frame to the given URL. In case of multiple redirects, the navigation will resolve with the first non-redirect response. The method will throw an error if navigation fails. The method will not throw an error when any valid HTTP status code is returned by the remote server.
Upstream docs
​
url
string
required
​
options
PlaywrightGotoOptions
​
result
SerializedHandle | null
Return value
await frame.goto('...');

​
waitForURL

Waits for the frame to navigate to the given URL.
This method can be used after an action that causes navigation. A glob pattern, regex pattern or predicate receiving URL to match while waiting for the navigation.
Upstream docs
​
url
string | RegExp | ((url: URL) => boolean)
required
​
options
PlaywrightWaitForURLOptions
await frame.waitForURL(/* string | RegExp | ((url: URL) => boolean) */);

​
waitForLoadState

Waits for the required load state to be reached.
This method returns when the page reaches a required load state, ‘load’ by default. The navigation must have been committed when this method is called.
Upstream docs
​
state
"load" | "domcontentloaded" | "networkidle"
State to wait for, defaults to load.
​
options
{ timeout?: number }
await frame.waitForLoadState();