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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
CloseWindow

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Siehe auch