Get Window Rect

Limited availability

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

Der Befehl Get Window Rect der WebDriver API gibt die Größe und Position des angegebenen WebElement zurück. Viele WebDriver-Clients bieten separate API-Methoden zur Abfrage der Position und der Abmessungen eines Elements, verwenden jedoch beide aus Optimierungsgründen diesen primitiven Befehl.

Der Befehl operiert auf dem aktuell ausgewählten Fenster und gibt 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 zur Manipulation der Position und der Abmessungen eines Fensters dient.

Syntax

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

URL-Parameter

session id

Bezeichner der Sitzung.

Antwort

Die Antwort-Payload ist ein WindowRect:

x

Horizontale Position des mit window assoziierten Betriebssystemfensters, entspricht Window.screenX.

y

Vertikale Position des mit window assoziierten Betriebssystemfensters, entspricht Window.screenY.

width

Breite der äußeren Begrenzungen des mit window assoziierten Betriebssystemfensters, entspricht Window.outerWidth.

height

Höhe der äußeren Begrenzungen des mit window assoziierten Betriebssystemfensters, entspricht Window.outerHeight.

Fehler

Invalid session ID

Sitzung existiert nicht.

Unexpected alert open

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

Spezifikationen

Specification
WebDriver
# get-window-rect

Browser-Kompatibilität

Siehe auch