11/11/23, 01:12 Get Window Handles - WebDriver | MDN

Get Window Handles

The Get Window Handles command of the WebDriver API returns a list of all WebWindow s. Each tab or window, depending on whether you are using a tabbed browser, is associated by a
window handle that is used as a reference when switching to the window.
In order to determine whether or not a particular interaction with the browser opens a new window, one can obtain the set of window handles before the interaction is performed and
compare it with the set after the action is performed.

Syntax
Method URI template
GET /session/{session id}/window/handles

URL parameters
session id

Identifier of the session.

Errors
Invalid session ID
Session does not exist.

Example
C#:
CPP
using System.Collections.ObjectModel;
using OpenQA.Selenium.Firefox;

namespace MDNWebDriverExamples
{
class Example
{
public static void Main(string[] args)
{
FirefoxDriver session = new FirefoxDriver();

session.ExecuteScript("window.open()");

ReadOnlyCollection<string> currentWindowHandles = session.WindowHandles;

}
}
}

Specifications
Specification
WebDriver
# dfn-get-window-handles

Browser compatibility
Report problems with this compatibility data on GitHub
diordnA rof xoferiF

tenretnI gnusmaS
diordnA emorhC

diordnA arepO

SOi no irafaS
emorhC

xoferiF

arepO

irafaS
egdE

Chrome 65 Edge 79 Firefox 55 Opera No Safari No Chrome No Firefox No Opera No Safari No Samsung No
GetWindowHandles Android for Android on Internet
Android iOS
Tip: you can click/tap on a cell for more information.
Full support No support See implementation notes.

See also
Switch To Window command
Get Window Handle command
Close Window command

This page was last modified on Jun 29, 2023 by MDN contributors.

https://developer.mozilla.org/en-US/docs/Web/WebDriver/Commands/GetWindowHandles 1/1