browser.createUserContext-Befehl - WebDriver

Syntax

json

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

Parameter

Setzen Sie params auf ein leeres Objekt ({}) oder fügen Sie eines der folgenden optionalen Felder hinzu:

acceptInsecureCerts Optional: Ein Boolescher Wert, der steuert, ob nicht vertrauenswürdige TLS-Zertifikate (beispielsweise selbstsignierte oder abgelaufene) innerhalb dieses Benutzerkontexts akzeptiert werden. Bei Festlegung überschreibt dieser Parameter die Sitzungsebene acceptInsecureCerts-Einstellung für diesen Benutzerkontext.
proxy Optional: Ein Objekt, das die Proxy-Konfiguration angibt, die der Browser für Netzwerk-Anfragen innerhalb dieses Benutzerkontexts verwenden soll. Bei Festlegung überschreibt dieser Parameter die Sitzungsebene proxy-Einstellung für diesen Benutzerkontext.
unhandledPromptBehavior Optional: Ein Objekt, das das Standardverhalten angibt, wenn ein Benutzer-Prompt (wie ein alert, confirm oder prompt-Dialog) innerhalb dieses Benutzerkontexts auftritt. Bei Festlegung überschreibt dieser Parameter die Sitzungsebene unhandledPromptBehavior-Einstellung für diesen Benutzerkontext.

Hinweis: Wird ein Parameter festgelegt, gilt er für alle bestehenden und zukünftigen Tabs innerhalb dieses Benutzerkontexts.

Rückgabewert

Das folgende Feld im result-Objekt der Antwort beschreibt den erstellten Benutzerkontext:

userContext: Ein String, der den erstellten Benutzerkontext eindeutig identifiziert.

Fehler

unsupported operation: acceptInsecureCerts ist true, aber der Browser unterstützt keine unsicheren TLS-Verbindungen, oder proxy ist angegeben, aber der Browser kann die Proxy-Einstellungen für diesen Benutzerkontext nicht konfigurieren oder die gegebene Proxy-Konfiguration nicht anwenden.

Beispiele

Erstellen eines Benutzerkontexts mit Standardeinstellungen

Mit einer WebDriver BiDi-Verbindung und einer aktiven Sitzung senden Sie die folgende Nachricht, um einen Benutzerkontext zu erstellen:

json

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

Der Browser antwortet mit einer erfolgreichen Erstellung des Benutzerkontexts wie folgt:

json

{
  "id": 1,
  "type": "success",
  "result": {
    "userContext": "4e4b1f6d-3f1a-4b2e-9f8c-1a2b3c4d5e6f"
  }
}

Erstellen eines Benutzerkontexts mit einem Proxy

Senden Sie die folgende Nachricht, um einen Benutzerkontext zu erstellen, der Netzwerk-Anfragen über einen Proxy leitet:

json

{
  "id": 2,
  "method": "browser.createUserContext",
  "params": {
    "proxy": {
      "proxyType": "manual",
      "httpProxy": "127.0.0.1:80"
    }
  }
}

Der Browser antwortet mit einer erfolgreichen Erstellung des Benutzerkontexts wie folgt:

json

{
  "id": 2,
  "type": "success",
  "result": {
    "userContext": "7d9e2a1b-5c3f-4e6d-8a7b-2c1d0e9f8a7b"
  }
}

Spezifikationen

Spezifikation
WebDriver BiDi # command-browser-createUserContext

Browser-Kompatibilität

Siehe auch

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden