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 zu Window.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 zu Window.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 zu Window.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 zu Window.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 zu Window.screenX.

y

Vertikale Position des mit dem window verbundenen Betriebssystemfensters, äquivalent zu Window.screenY.

width

Breite der äußeren Grenzen des mit dem window verbundenen Betriebssystemfensters, äquivalent zu Window.outerWidth.

height

Höhe der äußeren Grenzen des mit dem window verbundenen Betriebssystemfensters, äquivalent zu Window.outerHeight.

Fehler

Ungültiges Argument

Wenn eines der Felder im WindowRect Nutzlast-Objekt nicht den Typ- oder Bereichsbeschränkungen entspricht oder nur eines der x/y-Paare oder width/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