Close Window

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Der Close Window Befehl der WebDriver API schließt den aktuellen obersten Browsing-Kontext (Fenster oder Tab) und gibt die Liste der momentan geöffneten WebWindows zurück. Wenn es das letzte Fenster ist, das geschlossen wird, wird die WebDriver-Sitzung implizit gelöscht. Nachfolgende Befehle nach dem Ende der Sitzung führen daher zu ungültigen Sitzungs-ID Fehlern.

Syntax

Methode URI-Vorlage
DELETE /session/{session id}/window

URL-Parameter

session id

Bezeichner der Sitzung.

Fehler

Ungültige Sitzungs-ID

Sitzung existiert nicht.

Unerwartetes offenes Alert

Eine Benutzeraufforderung, wie z.B. window.alert, blockiert die Ausführung des Befehls, bis sie bearbeitet wird.

Beispiel

Python:

python
from selenium import webdriver

session = webdriver.Firefox()
original_window = session.window_handle

new_window = session.execute_script("return window.open()")
session.switch_to.window(new_window)

session.close()
session.switch_to.window(original_window)

C#:

cpp
using OpenQA.Selenium.Firefox;

namespace MDNWebDriverExamples
{
    class Example
    {
        public static void Main(string[] args)
        {
            FirefoxDriver session = new FirefoxDriver();
            string original_window = session.CurrentWindowHandle;// Optional if you want to store the handle in a variable

            session.ExecuteScript("window.open()");
            session.SwitchTo().Window(session.WindowHandles[1]); // Switch to the second window

            session.Close(); // Close current window
            session.SwitchTo().Window(session.WindowHandles[0]); // Switch back to the first window
        }
    }
}

Spezifikationen

Specification
WebDriver
# close-window

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch