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 (z.B. selbstsignierte oder abgelaufene) innerhalb dieses Benutzerkontexts akzeptiert werden. Wenn gesetzt, überschreibt es die sitzungsspezifische acceptInsecureCerts-Einstellung für diesen Benutzerkontext.
proxy Optional: Ein Objekt, das die Proxy-Konfiguration spezifiziert, die der Browser für Netzwerk-Anfragen innerhalb dieses Benutzerkontexts verwenden soll. Wenn gesetzt, überschreibt es die sitzungsspezifische proxy-Einstellung für diesen Benutzerkontext.
unhandledPromptBehavior Optional: Ein Objekt, das das Standardverhalten angibt, wenn innerhalb dieses Benutzerkontexts eine Benutzeraufforderung (wie ein alert, confirm oder prompt-Dialog) auftritt. Wenn gesetzt, überschreibt es die sitzungsspezifische unhandledPromptBehavior-Einstellung für diesen Benutzerkontext.

Hinweis: Wenn ein Parameter gesetzt ist, 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 die ID enthält, die den erstellten Benutzerkontext eindeutig identifiziert.

Fehler

invalid argument: Ein benötigter 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 spezifiziert, aber der Browser kann keine Proxy-Einstellungen für diesen Benutzerkontext konfigurieren oder die gegebene Proxy-Konfiguration nicht anwenden.

Beispiele

Einen Benutzerkontext mit Standardeinstellungen erstellen

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"
  }
}

Einen Benutzerkontext mit einem Proxy erstellen

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

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