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 verknüpft ist. Der Befehl fungiert als Setter von Get Window Rect, dessen Rückgabeobjekt Sie direkt als Nutzlast dieses Befehls verwenden können.

Bestimmte Gerätegruppen unterstützen das Festlegen der Fensterabmessungen oder -positionen nicht. In diesen Konfigurationen gibt der Befehl einen unsupported operating Fehler zurück. Um Situationen zu vermeiden, in denen dieser Befehl zu einem Fehler führen könnte, kann er bedingt aufgerufen werden, wenn die setWindowRect-Fähigkeit für die Sitzung auf true gesetzt ist.

Das Festlegen des Fenster-Rechtecks nimmt x, y, width und height als Eingabe. Alle Felder sind optional, z.B. kann der Befehl mit einem leeren Objekt aufgerufen werden, 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 ist es nicht garantiert, dass die resultierende Fenstergröße genau der gewünschten Größe entspricht. Der Treiber wird voraussichtlich Werte klemmen, die größer als die physischen Bildschirmabmessungen oder kleiner als die Mindestfenstergröße sind. Einige Treiber haben möglicherweise auch andere Einschränkungen, wie z. B. das Nichtverkleinern in Einzelpixel-Schritten. Aus diesem Grund könnten die zurückgegebenen width und height nicht genau mit Window.outerWidth und Window.outerHeight übereinstimmen.

Das Festlegen der Fensterposition ähnelt vom Charakter her dem Aufruf von Window.moveTo(x, y), unterscheidet sich jedoch, indem es Sicherheitsbeschränkungen im Zusammenhang mit der Fensterverwaltung umgeht.

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 Window.screenX entspricht. Muss eine Zahl im Bereich −(2^31) bis 2^31 − 1 sein, null oder undefined.

y

Vertikale Position des window, die Window.screenY entspricht. Muss eine Zahl im Bereich −(2^31) bis 2^31 − 1 sein, null oder undefined.

width

Äußere Breite des window, die Window.outerWidth entspricht. Muss eine Zahl im Bereich 0 bis 2^31 − 1 sein, null oder undefined.

height

Äußere Breite des window, die Window.outerHeight entspricht. Muss eine Zahl im Bereich 0 bis 2^31 − 1 sein, null oder undefined.

Antwort

Die Antwort-Nutzlast ist ein WindowRect:

x

Horizontale Position des Betriebssystem-Fensters, das mit window verbunden ist, entspricht Window.screenX.

y

Vertikale Position des Betriebssystem-Fensters, das mit window verbunden ist, entspricht Window.screenY.

width

Breite der äußeren Begrenzungen des Betriebssystem-Fensters, das mit window verbunden ist, entspricht Window.outerWidth.

height

Höhe der äußeren Begrenzungen des Betriebssystem-Fensters, das mit window verbunden ist, entspricht Window.outerHeight.

Fehler

Ungültiges Argument

Wenn eines der Felder im WindowRect Nutzlast-Objekt die Typ- oder Grenzvorschriften nicht erfüllt oder wenn nur eines der x/y Paare oder width/height Paar-Felder angegeben ist.

Ungültige Sitzungs-ID

Sitzung existiert nicht.

Kein solches Fenster

Wenn das window geschlossen wurde.

Unerwartetes Alert-Fenster geöffnet

Eine Benutzeraufforderung, wie window.alert, blockiert die Ausführung des Befehls, bis sie behandelt 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 eine feste Dimension hat und nicht auf dem Bildschirm verschoben werden kann.

Sie können die setWindowRect-Fähigkeit prüfen, um festzustellen, ob das Gerät diesen Befehl unterstützt.

Spezifikationen

Specification
WebDriver
# set-window-rect

Browser-Kompatibilität

Siehe auch