browser.createUserContext-Befehl - WebDriver

Syntax

json

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

Parameter

Setzen Sie params auf ein leeres Objekt ({}) oder schließen Sie eines der folgenden optionalen Felder ein:

acceptInsecureCerts Optional: Ein boolescher Wert, der steuert, ob nicht vertrauenswürdige TLS-Zertifikate (zum Beispiel selbstsignierte oder abgelaufene) innerhalb dieses Benutzerkontextes akzeptiert werden. Wenn festgelegt, überschreibt er die Session-Ebene acceptInsecureCerts Einstellung für diesen Benutzerkontext.
proxy Optional: Ein Objekt, das die Proxy-Konfiguration angibt, die der Browser für Netzwerk-Anfragen innerhalb dieses Benutzerkontextes verwenden soll. Wenn festgelegt, überschreibt es die Session-Ebene proxy Einstellung für diesen Benutzerkontext.
unhandledPromptBehavior Optional: Ein Objekt, das das Standardverhalten angibt, wenn ein Benutzer-Dialogfeld (wie ein alert, confirm oder prompt Dialog) innerhalb dieses Benutzerkontextes aufgerufen wird. Wenn festgelegt, überschreibt es die Session-Ebene unhandledPromptBehavior Einstellung für diesen Benutzerkontext.

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

Rückgabewert

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

userContext: Ein String, der die ID (UUID) enthält, die den erstellten Benutzerkontext eindeutig identifiziert.

Fehler

invalid argument: Ein erforderlicher Parameter fehlt oder hat einen ungültigen Typ.
unsupported operation: acceptInsecureCerts ist true, aber der Browser unterstützt keine unsicheren TLS-Verbindungen, oder proxy ist angegeben, aber der Browser kann keine Proxy-Einstellungen für diesen Benutzerkontext konfigurieren oder kann die angegebene Proxy-Konfiguration nicht anwenden.

Beispiele

Erstellen eines Benutzerkontextes 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 Benutzerkontextes wie folgt:

json

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

Erstellen eines Benutzerkontextes 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 Benutzerkontextes 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