Method Window

dotnet/src/webdriver/TargetLocator.cs:137–176

Change to the Window by passing in the name Window handle or name of the window that you wish to move to A WebDriver instance that is currently in use If is .

(string windowHandleOrName)

    /// <returns>A WebDriver instance that is currently in use</returns>
    /// <exception cref="ArgumentNullException">If <paramref name="windowHandleOrName"/> is <see langword="null"/>.</exception>
    public IWebDriver Window(string windowHandleOrName)
    {
        ArgumentNullException.ThrowIfNull(windowHandleOrName);

        Dictionary<string, object?> parameters = new Dictionary<string, object?>();
        parameters.Add("handle", windowHandleOrName);
        try
        {
            this.driver.Execute(DriverCommand.SwitchToWindow, parameters);
            return this.driver;
        }
        catch (NoSuchWindowException)
        {
            // simulate search by name
            string? original = null;
            try
            {
                original = this.driver.CurrentWindowHandle;
            }
            catch (NoSuchWindowException)
            {
            }

            foreach (string handle in this.driver.WindowHandles)
            {
                this.Window(handle);
                if (windowHandleOrName == this.driver.ExecuteScript("return window.name")!.ToString())
                {
                    return this.driver; // found by name
                }
            }

            if (original != null)
            {
                this.Window(original);
            }

            throw;
        }
    }

    /// <summary>
    /// Creates a new browser window and switches the focus for future commands