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 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
| Specification |
|---|
| WebDriver # get-window-rect |
Browser-Kompatibilität
Siehe auch
- WebWindow
- Zugehörige Befehle: