browser.getUserContexts-Kommando

Syntax

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

Parameter

Keine. Sie müssen jedoch das params-Feld einfügen und es 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 enthält das folgende Feld:

userContext

Ein String, der 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 abzurufen:

{
  "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 Erstellung 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 dem default, 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-Kommando
• browser.createUserContext-Kommando
• browser.removeUserContext-Kommando