Get Window Rect

Limited availability

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

Der Get Window Rect Befehl der WebDriver API gibt die Größe und Position des angegebenen WebElement zurück. Viele WebDriver-Clients bieten separate API-Methoden zum Abrufen des Standorts und der Abmessungen eines Elements an, aber als Optimierung verwenden sie beide diesen grundlegenden Befehl.

Der Befehl operiert auf dem aktuell ausgewählten Fenster und gibt die Größe und Position des Betriebssystemfensters zurück. Das zurückgegebene WindowRect kann als Eingabe für den Set Window Rect-Befehl verwendet werden, der zum Ändern der Position und der Abmessungen eines Fensters dient.

Syntax

Methode URI-Vorlage
GET /session/{session id}/window/rect

URL-Parameter

session id

Kennung der Sitzung.

Antwort

Die Antwortnutzlast ist ein WindowRect:

x

Horizontale Position des Betriebssystemfensters, das mit window assoziiert ist, entsprechend Window.screenX.

y

Vertikale Position des Betriebssystemfensters, das mit window assoziiert ist, entsprechend Window.screenY.

width

Breite der äußeren Grenzen des Betriebssystemfensters, das mit window assoziiert ist, entsprechend Window.outerWidth.

height

Höhe der äußeren Grenzen des Betriebssystemfensters, das mit window assoziiert ist, entsprechend Window.outerHeight.

Fehler

Ungültige Sitzungs-ID

Sitzung existiert nicht.

Unerwartetes geöffnetes Fenster

Ein Benutzerhinweis, wie beispielsweise window.alert, blockiert die Ausführung des Befehls, bis er bearbeitet wird.

Spezifikationen

Specification
WebDriver
# get-window-rect

Browser-Kompatibilität

Siehe auch