browser.getUserContexts-Befehl

Syntax

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

Parameter

Keine. Sie müssen jedoch das params-Feld einfügen und auf ein leeres Objekt ({}) setzen.

Rückgabewert

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

userContexts

Ein Array von einem oder mehreren Objekten, die jeweils einen Benutzerkontext darstellen. Jedes Objekt hat das folgende Feld:

userContext

Ein String, der die ID (UUID) enthält, die den Benutzerkontext eindeutig identifiziert. Der Standard-Benutzerkontext hat den Wert "default"; er existiert immer und kann nicht entfernt werden, sodass das Array niemals leer ist.

Beispiele

Abrufen einer Liste von Benutzerkontexten

Mit einer WebDriver BiDi-Verbindung und einer aktiven Sitzung senden Sie die folgende Nachricht, um eine Liste aller Benutzerkontexte zu erhalten:

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

Wenn nur der Standard-Benutzerkontext existiert, antwortet der Browser wie folgt:

{
  "id": 1,
  "type": "success",
  "result": {
    "userContexts": [
      {
        "userContext": "default"
      }
    ]
  }
}

Abrufen einer Liste von Benutzerkontexten nach dem Erstellen zusätzlicher Kontexte

Nachdem Sie einige Benutzerkontexte mit browser.createUserContext erstellt haben, senden Sie die folgende Nachricht, um alle aufzulisten:

{
  "id": 2,
  "method": "browser.getUserContexts",
  "params": {}
}

Der Browser antwortet mit allen Benutzerkontexten, einschließlich des default-Kontextes, wie folgt:

{
  "id": 2,
  "type": "success",
  "result": {
    "userContexts": [
      {
        "userContext": "default"
      },
      {
        "userContext": "4e4b1f6d-3f1a-4b2e-9f8c-1a2b3c4d5e6f"
      },
      {
        "userContext": "7d9e2a1b-5c3f-4e6d-8a7b-2c1d0e9f8a7b"
      }
    ]
  }
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• session.new-Befehl
• browser.createUserContext-Befehl
• browser.removeUserContext-Befehl