Get Window Rect
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
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 Dimensionen eines Elements an, nutzen jedoch zur Optimierung beide dieses Primitive.
Der Befehl arbeitet mit 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 Befehl Set Window Rect verwendet werden, welcher zur Manipulation der Position und Dimensionen eines Fensters dient.
Syntax
| Methode | URI-Vorlage |
|---|---|
GET |
/session/{session id}/window/rect |
URL-Parameter
session id-
Bezeichner der Sitzung.
Antwort
Die Antwortnutzlast ist ein WindowRect:
x-
Horizontale Position des Betriebssystemfensters, das mit
windowverbunden ist, äquivalent zuWindow.screenX. y-
Vertikale Position des Betriebssystemfensters, das mit
windowverbunden ist, äquivalent zuWindow.screenY. width-
Breite der äußeren Begrenzungen des Betriebssystemfensters, das mit
windowverbunden ist, äquivalent zuWindow.outerWidth. height-
Höhe der äußeren Begrenzungen des Betriebssystemfensters, das mit
windowverbunden ist, äquivalent zuWindow.outerHeight.
Fehler
- Ungültige Sitzungs-ID
-
Sitzung existiert nicht.
- Unerwarteter Alert geöffnet
-
Eine Benutzereingabeaufforderung, wie z. B.
window.alert, blockiert die Ausführung des Befehls, bis sie behandelt wird.
Spezifikationen
| Spezifikation |
|---|
| WebDriver> # get-window-rect> |
Browser-Kompatibilität
Siehe auch
- WebWindow
- Zugehörige Befehle: