# switchWindow

Switch focus to a particular tab / window.

## Usage[​](#usage "Direct link to Usage")

```
await browser.switchWindow(matcher)
```

## Parameters[​](#parameters "Direct link to Parameters")

| Name      | Type             | Details                                                                                                       |
| --------- | ---------------- | ------------------------------------------------------------------------------------------------------------- |
| `matcher` | `String, RegExp` | String or regular expression that matches either the page title or URL, the window name, or the window handle |

## Example[​](#example "Direct link to 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)
});
```