TheGet Window Handlescommand of theWebDriver API returns a list of allWebWindows. Each tab or window, depending on whether you are using a tabbed browser, is associated by awindow handle that is used as a reference whenswitching 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

URL parameters

session id

Identifier of the session.

Errors

Invalid session ID

Session does not exist.

Example

C#:

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

Browser compatibility

See also

• Switch To Window command
• Get Window Handle command
• Close Window command