browser.removeUserContext Befehl
Der browser.removeUserContext Befehl des browser Moduls entfernt den angegebenen Benutzerkontext und alle seine Tabs in allen Fenstern. Tabs werden geschlossen, ohne dass die beforeunload Ereignishandlerfunktionen ausgeführt werden.
Warnung: Dieser Befehl ist unwiderruflich, und alle dem Benutzerkontext zugeordneten Speicher werden dauerhaft gelöscht.
Syntax
{
"method": "browser.removeUserContext",
"params": {
"userContext": "4e4b1f6d-3f1a-4b2e-9f8c-1a2b3c4d5e6f"
}
}
Parameter
Das params-Feld enthält:
userContext-
Ein String, der die ID des zu entfernenden Benutzerkontexts enthält. Benutzerkontext-IDs werden von Befehlen wie
browser.createUserContextoderbrowser.getUserContextszurückgegeben. Der Standardbenutzerkontext ("default") kann nicht entfernt werden.
Rückgabewert
Das result-Feld in der Antwort ist ein leeres Objekt ({}).
Fehler
invalid argument-
Das
userContext-Feld ist"default". Der Standardbenutzerkontext kann nicht entfernt werden. no such user context-
Kein Benutzerkontext mit der angegebenen Benutzerkontext-ID gefunden.
Beispiele
Entfernen eines Benutzerkontexts
Betrachten Sie ein Szenario, bei dem Sie eine WebDriver-BiDi-Verbindung und eine aktive Sitzung haben. Nachdem Sie einen Benutzerkontext erstellt haben mit browser.createUserContext, senden Sie die folgende Nachricht, wenn Sie ihn entfernen möchten:
{
"id": 1,
"method": "browser.removeUserContext",
"params": {
"userContext": "4e4b1f6d-3f1a-4b2e-9f8c-1a2b3c4d5e6f"
}
}
Der Browser antwortet mit einer erfolgreichen Entfernung wie folgt:
{
"id": 1,
"type": "success",
"result": {}
}
Spezifikationen
| Spezifikation |
|---|
| WebDriver BiDi # command-browser-removeUserContext |
Browser-Kompatibilität
Siehe auch
session.newBefehlbrowser.createUserContextBefehlbrowser.getUserContextsBefehlbrowser.closeBefehlsession.endBefehl