Skip to main content

switchWindow

Switch focus to a particular tab / window.

Usage​

await browser.switchWindow(matcher)

Parameters​

NameTypeDetails
matcherString, RegExpString or regular expression that matches either the page title or URL, the window name, or the window handle

Example​

switchWindow.js
it('should switch to another window', async () => {
// open url
await browser.url('https://google.com')

// get window handle
const handle = await browser.getWindowHandle()

// create new window
await browser.newWindow('https://webdriver.io')

// switch back via url match
await browser.switchWindow('google.com')

// switch back via title match
await browser.switchWindow('Next-gen browser and mobile automation test framework for Node.js')

// switch back via window handle
await browser.switchWindow(handle)
});

Welcome! How can I help?

WebdriverIO AI Copilot