browser.getClientWindows Befehl

Syntax

{
  "method": "browser.getClientWindows",
  "params": {}
}

Parameter

Keine. Allerdings müssen Sie das Feld params einschließen und auf ein leeres Objekt ({}) setzen.

Rückgabewert

Das folgende Feld im result-Objekt der Antwort beschreibt die Client-Fenster im Browser:

clientWindows

Ein Array von Objekten, jedes repräsentiert ein Client-Fenster. Das Array kann leer sein, wenn der Browser keine geöffneten Fenster hat. Jedes Objekt hat die folgenden Felder:

active

Ein boolescher Wert, der angibt, ob das Client-Fenster Tastatureingaben vom Betriebssystem empfangen kann. Dies kann bedeuten, dass ein Tab innerhalb des Fensters Fokus hat oder dass die Browser-Oberfläche selbst fokussiert ist.

clientWindow

Ein String, der das Client-Fenster eindeutig identifiziert.

height

Eine Zahl, die die Höhe des Fensters in CSS-Pixeln angibt.

state

Ein String, der den aktuellen Zustand des Fensters angibt.

"fullscreen"

Gibt an, dass das Fenster im Vollbildmodus ist.

"maximized"

Gibt an, dass das Fenster maximiert ist, um den Bildschirmbereich auszufüllen.

"minimized"

Gibt an, dass das Fenster minimiert (aus dem Sichtfeld verborgen) ist.

"normal"

Gibt an, dass das Fenster in seinem normalen (wiederhergestellten) Zustand ist.

width

Eine Zahl, die die Breite des Fensters in CSS-Pixeln angibt.

x

Eine Zahl, die die x-Koordinate des Fensters in CSS-Pixeln angibt, gemessen vom linken Rand des Bildschirmbereichs.

y

Eine Zahl, die die y-Koordinate des Fensters in CSS-Pixeln angibt, gemessen vom oberen Rand des Bildschirmbereichs.

Beispiele

Abrufen aller Client-Fenster

Mit einer WebDriver BiDi-Verbindung und einer aktiven Sitzung, senden Sie die folgende Nachricht, um alle Client-Fenster abzurufen:

{
  "id": 1,
  "method": "browser.getClientWindows",
  "params": {}
}

Der Browser antwortet erfolgreich mit der Liste der Client-Fenster wie folgt:

{
  "id": 1,
  "type": "success",
  "result": {
    "clientWindows": [
      {
        "active": true,
        "clientWindow": "09a7bf22-c52d-4011-88ad-507a7e0012c7",
        "height": 970,
        "state": "normal",
        "width": 1280,
        "x": 4,
        "y": 38
      }
    ]
  }
}

Abrufen von Client-Fenstern, wenn mehrere Browserfenster geöffnet sind

Wenn mehrere Browserfenster geöffnet sind, antwortet der Browser mit einem Eintrag pro Fenster wie folgt:

{
  "id": 2,
  "type": "success",
  "result": {
    "clientWindows": [
      {
        "active": true,
        "clientWindow": "09a7bf22-c52d-4011-88ad-507a7e0012c7",
        "height": 800,
        "state": "normal",
        "width": 1280,
        "x": 0,
        "y": 26
      },
      {
        "active": false,
        "clientWindow": "b3f8a1e5-d4c2-4e9f-8b3a-1f2e3d4c5b6a",
        "height": 0,
        "state": "minimized",
        "width": 0,
        "x": 0,
        "y": 0
      }
    ]
  }
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• session.new Befehl
• browser.setClientWindowState Befehl