Skip to main content

newWindow

Open new window in browser. This command is the equivalent function to window.open(). This command does not work in mobile environments.

Note: When calling this command you automatically switch to the new window.

Usage
browser.newWindow(url, { windowName, windowFeatures })
Parameters
NameTypeDetails
urlStringwebsite URL to open
options
optional		NewWindowOptionsnewWindow command options
options.windowName
optional		Stringname of the new window
options.windowFeatures
optional		Stringfeatures of opened window (e.g. size, position, scrollbars, etc.)
Example
newWindowSync.js
it('should open a new tab', async () => {
    await browser.url('https://google.com')
    console.log(await browser.getTitle()) // outputs: "Google"

    await browser.newWindow('https://webdriver.io', {
        windowName: 'WebdriverIO window',
        windowFeature: 'width=420,height=230,resizable,scrollbars=yes,status=1',
    })
    console.log(await browser.getTitle()) // outputs: "WebdriverIO · Next-gen browser and mobile automation test framework for Node.js"

    const handles = await browser.getWindowHandles()
    await browser.switchToWindow(handles[1])
    await browser.closeWindow()
    await browser.switchToWindow(handles[0])
    console.log(await browser.getTitle()) // outputs: "Google"
});