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 Abmessungen eines Elements an, aber zur Optimierung verwenden 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 Set Window Rect Befehl verwendet werden, um die Position und Abmessungen eines Fensters zu manipulieren.
Syntax
| Methode | URI-Vorlage |
|---|---|
GET |
/session/{session id}/window/rect |
URL-Parameter
session id-
Identifikator der Sitzung.
Antwort
Das Antwort-Payload ist ein WindowRect:
x-
Horizontale Position des Betriebssystemfensters, das mit
windowassoziiert ist, entsprichtWindow.screenX. y-
Vertikale Position des Betriebssystemfensters, das mit
windowassoziiert ist, entsprichtWindow.screenY. width-
Breite der äußeren Grenzen des Betriebssystemfensters, das mit
windowassoziiert ist, entsprichtWindow.outerWidth. height-
Höhe der äußeren Grenzen des Betriebssystemfensters, das mit
windowassoziiert ist, entsprichtWindow.outerHeight.
Fehler
invalid session id-
Die Sitzung existiert nicht.
unexpected alert open-
Eine Benutzeraufforderung, wie
window.alert, blockiert die Ausführung des Befehls, bis sie bearbeitet wird.
Spezifikationen
| Spezifikation |
|---|
| WebDriver> # get-window-rect> |
Browser-Kompatibilität
Siehe auch
- WebWindow
- Zugehörige Befehle: