Taiko
Documentation

Home / API Reference

goto

Opens the specified URL in the browser's tab. Adds http protocol to the URL if not present.

Examples

await goto('https://google.com')
await goto('google.com')
await goto('example.com',{ navigationTimeout:10000, headers:{'Authorization':'Basic cG9zdG1hbjpwYXNzd29y2A=='}})
const response = await goto('gauge.org'); if(response.status.code === 200) {console.log("Success!!")}
response: {
redirectedResponse: [
 {
   url: 'http://gauge.org/',
   status: { code: 307, text: 'Internal Redirect' }
 }
],
url: 'https://gauge.org/',
status: { code: 200, text: '' }
}

Parameters


url

URL to navigate page to.


options

options.waitForNavigation boolean

Wait for navigation after the goto. Default navigationTimeout is 30 seconds to override pass { navigationTimeout: 10000 } in options parameter.

Default value
true

options.waitForEvents Array<string>

Events available to wait for ['DOMContentLoaded', 'loadEventFired', 'networkAlmostIdle', 'networkIdle', 'firstPaint', 'firstContentfulPaint', 'firstMeaningfulPaint', 'targetNavigated']

Default value
[]

options.navigationTimeout number

Navigation timeout value in milliseconds for navigation after click.

Default value
30000

options.headers

Map with extra HTTP headers.


options.waitForStart number

time to wait for navigation to start. Accepts value in milliseconds.

Default value
100

Returns

response

Promise<Object>