Fensterrechteck setzen

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 für Get Window Rect, dessen Rückgabeobjekt Sie direkt als Nutzlast für diesen Befehl übergeben können.

Bestimmte Geräte unterstützen das Setzen der Fenstermaße oder -position nicht. In diesen Konfigurationen wird der Befehl einen unsupported operation Fehler zurückgeben. Um Situationen zu vermeiden, in denen dieser Befehl möglicherweise einen Fehler verursacht, kann er bedingt aufgerufen werden, wenn die setWindowRect Fähigkeit für die Sitzung auf true gesetzt ist.

Das Setzen des Fensterrechtecks erfordert 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 hat er keine Wirkung. Um die Position festzulegen, sind sowohl x als auch y erforderlich, und entsprechend sind sowohl width als auch height notwendig, um die Fenstergröße zu ändern.

Beim Einstellen der Breite oder Höhe ist nicht garantiert, dass die resultierende Fenstergröße genau dem angeforderten Wert entspricht. Der Treiber soll Werte begrenzen, 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. die Unfähigkeit, die Größe in Ein-Pixel-Schritten zu ändern. Aus diesem Grund entsprechen die zurückgegebenen width und height möglicherweise nicht genau Window.outerWidth und Window.outerHeight.

Das Setzen der Fensterposition ist vergleichbar mit dem Aufruf von Window.moveTo(x, y), unterscheidet sich jedoch dadurch, dass es die Sicherheitsbeschränkungen im Zusammenhang mit der Fensterverwaltung umgeht.

Der Befehl Fensterrechteck setzen ist blockierend.

Syntax

Methode URI-Vorlage
POST /session/{session id}/window/rect

URL-Parameter

session id

Kennung 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

Außenbreite des window, die äquivalent zu Window.outerWidth ist. Muss eine Zahl im Bereich von 0 bis 2^31 − 1, null oder undefiniert sein.

height

Außenhö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 Antwortnutzlast ist ein WindowRect:

x

Horizontale Position des Betriebssystemfensters, das mit window verknüpft ist, äquivalent zu Window.screenX.

y

Vertikale Position des Betriebssystemfensters, das mit window verknüpft ist, äquivalent zu Window.screenY.

width

Breite der äußeren Grenzen des Betriebssystemfensters, das mit window verknüpft ist, äquivalent zu Window.outerWidth.

height

Höhe der äußeren Grenzen des Betriebssystemfensters, das mit window verknüpft ist, äquivalent zu Window.outerHeight.

Fehler

Ungültiges Argument

Wenn eines der Felder im WindowRect-Nutzlastobjekt nicht die Typ- oder Bereichseinschränkungen erfüllt oder wenn nur eines der Felder x/y oder width/height angegeben ist.

Ungültige Sitzungs-ID

Sitzung existiert nicht.

Kein solches Fenster

Wenn das window geschlossen wurde.

Unerwartete Warnung offen

Eine Benutzeraufforderung, wie z. B. 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 feste Maße hat und nicht auf dem Bildschirm bewegt werden kann.

Sie können die setWindowRect Fähigkeit inspizieren, um festzustellen, 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