Set Window Rect
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Der Set Window Rect Befehl der WebDriver API ändert die Größe und Position des Betriebssystemfensters, das mit dem aktuellen window
verbunden ist. Der Befehl fungiert als Setter von Get Window Rect, dessen Ergebnisobjekt direkt als Nutzlast dieses Befehls übergeben werden kann.
Bestimmte Gerätegruppen unterstützen nicht das Setzen von Fenstermaßen oder deren Position. Auf diesen Konfigurationen gibt der Befehl einen unsupported operating Fehler zurück. Um Situationen zu vermeiden, in denen dies zu einem Fehler führt, kann der Befehl bedingt aufgerufen werden, wenn die setWindowRect
Fähigkeit für die Sitzung auf true gesetzt ist.
Das Festlegen des Fensterbereichs erfolgt durch die Eingaben x
, y
, width
und height
. Alle Felder sind optional, z.B. kann der Befehl mit einem leeren Objekt aufgerufen werden, und in diesem Fall wird er als No-Op fungieren. Um die Position festzulegen, sind sowohl x
als auch y
erforderlich, und entsprechend sind sowohl width
als auch height
erforderlich, um die Dimensionen des Fensters zu ändern.
Beim Festlegen der Breite oder Höhe wird nicht garantiert, dass die resultierende Fenstergröße genau dem entspricht, was angefordert wurde. Der Treiber wird erwartet, Werte zu klemmen, die größer als die physischen Bildschirmabmessungen oder kleiner als die minimale Fenstergröße sind. Einige Treiber haben möglicherweise auch andere Einschränkungen, wie die Unfähigkeit, in Einzelpixel-Schritten zu skalieren. Aus diesem Grund stimmen der zurückgegebene width
und height
möglicherweise nicht genau mit Window.outerWidth
und Window.outerHeight
überein.
Das Festlegen der Fensterposition ist ähnlich wie der Aufruf von Window.moveTo(x, y)
, unterscheidet sich jedoch dadurch, dass Sicherheitsbeschränkungen im Zusammenhang mit der Fensterbearbeitung umgangen werden.
Der Set Window Rect Befehl ist blockierend.
Syntax
Methode | URI-Vorlage |
---|---|
POST | /session/{session id}/window/rect |
URL-Parameter
session id
-
Bezeichner der Sitzung.
Nutzlast
Die Eingabe ist ein WindowRect
Objekt:
x
-
Horizontale Position des
window
, die äquivalent zuWindow.screenX
ist. Muss eine Zahl im Bereich von −(2^31) bis 2^31 − 1, null, oder undefiniert sein. y
-
Vertikale Position des
window
, die äquivalent zuWindow.screenY
ist. Muss eine Zahl im Bereich von −(2^31) bis 2^31 − 1, null, oder undefiniert sein. width
-
Äußere Breite des
window
, die äquivalent zuWindow.outerWidth
ist. Muss eine Zahl im Bereich von 0 bis 2^31 − 1, null, oder undefiniert sein. height
-
Äußere Höhe des
window
, die äquivalent zuWindow.outerHeight
ist. Muss eine Zahl im Bereich von 0 bis 2^31 − 1, null, oder undefiniert sein.
Antwort
Die Nutzlast der Antwort ist ein WindowRect
:
x
-
Horizontale Position des mit dem
window
verbundenen Betriebssystemfensters, äquivalent zuWindow.screenX
. y
-
Vertikale Position des mit dem
window
verbundenen Betriebssystemfensters, äquivalent zuWindow.screenY
. width
-
Breite der äußeren Grenzen des mit dem
window
verbundenen Betriebssystemfensters, äquivalent zuWindow.outerWidth
. height
-
Höhe der äußeren Grenzen des mit dem
window
verbundenen Betriebssystemfensters, äquivalent zuWindow.outerHeight
.
Fehler
- Ungültiges Argument
-
Wenn eines der Felder im
WindowRect
Nutzlast-Objekt nicht den Typ- oder Bereichsbeschränkungen entspricht oder nur eines derx
/y
-Paare oderwidth
/height
-Felder angegeben wird. - Ungültige Sitzungs-ID
-
Sitzung existiert nicht.
- Kein solches Fenster
-
Wenn das
window
geschlossen wurde. - Unerwartetes Warnungsfenster geöffnet
-
Ein Benutzerprompt, wie
window.alert
, blockiert die Ausführung des Befehls, bis es bearbeitet wird. - Nicht unterstützte Operation
-
Wenn der Treiber das Ändern der Fenstergröße oder -position nicht unterstützt. Dies ist normalerweise bei mobilen Geräten der Fall, bei denen der Browser feste Abmessungen hat und nicht auf dem Bildschirm bewegt werden kann.
Sie können die
setWindowRect
Fähigkeit inspizieren, um zu überprüfen, ob das Gerät diesen Befehl unterstützt.
Spezifikationen
Specification |
---|
WebDriver # set-window-rect |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
-
WebWindow
Objekt -
Zugehörige Befehle: