Fenster-Rechteck setzen

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Der Fenster-Rechteck setzen Befehl der WebDriver API ändert die Größe und Position des Betriebssystemfensters, das mit dem aktuellen window assoziiert ist. Der Befehl fungiert als Setter für Fenster-Rechteck abrufen, dessen zurückgegebenes Objekt Sie direkt als Nutzlast für diesen Befehl übergeben können.

Bestimmte Gerätegruppen unterstützen nicht die Einstellung der Fensterdimensionen oder deren Position. Auf diesen Konfigurationen gibt der Befehl einen nicht unterstützten Betrieb Fehler zurück. Um zu vermeiden, dass dieser Aufruf zu einem Fehler führt, kann er bedingt aufgerufen werden, wenn die setWindowRect Fähigkeit für die Sitzung auf true gesetzt ist.

Das Setzen des Fenster-Rechtecks benötigt x, y, width und height als Eingabe. Alle Felder sind optional, d.h. der Befehl kann 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 Fensterabmessungen zu ändern.

Beim Einstellen der Breite oder Höhe wird nicht garantiert, dass die resultierende Fenstergröße genau dem entspricht, was angefordert wurde. Der Treiber sollte Werte clampen, die größer als die physischen Bildschirmabmessungen oder kleiner als die Mindestgröße des Fensters sind. Einige Treiber können auch andere Einschränkungen haben, wie z.B. die Unfähigkeit, in Ein-Pixel-Schritten die Größe zu ändern. Aus diesem Grund könnten die zurückgegebenen width und height nicht genau mit Window.outerWidth und Window.outerHeight übereinstimmen.

Das Setzen der Fensterposition ist ähnlich wie der Aufruf von Window.moveTo(x, y), unterscheidet sich jedoch dadurch, dass es Sicherheitsbeschränkungen im Zusammenhang mit der Fenster-Manipulation umgeht.

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

y

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

width

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

height

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

Antwort

Die Antwortnutzlast ist ein WindowRect:

x

Horizontale Position des Betriebssystemfensters, das mit window assoziiert ist, was Window.screenX entspricht.

y

Vertikale Position des Betriebssystemfensters, das mit window assoziiert ist, was Window.screenY entspricht.

width

Breite der äußeren Grenzen des Betriebssystemfensters, das mit window assoziiert ist, was Window.outerWidth entspricht.

height

Höhe der äußeren Grenzen des Betriebssystemfensters, das mit window assoziiert ist, was Window.outerHeight entspricht.

Fehler

Ungültiges Argument

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

Ungültige Sitzungs-ID

Sitzung existiert nicht.

Kein solches Fenster

Wenn das window geschlossen wurde.

Unerwartetes offenes Alert

Eine Benutzeraufforderung, wie window.alert, blockiert die Ausführung des Befehls, bis sie behandelt wird.

Nicht unterstützter Betrieb

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 inspizieren, um festzustellen, ob das Gerät diesen Befehl unterstützt.

Spezifikationen

Specification
WebDriver
# set-window-rect

Browser-Kompatibilität

Siehe auch