browser.removeUserContext Befehl
Der browser.removeUserContext Befehl des browser Moduls entfernt den angegebenen Benutzerkontext und alle seine Tabs über alle Fenster hinweg. Tabs werden geschlossen, ohne die beforeunload Ereignis-Handler-Funktionen auszuführen.
Warnung: Dieser Befehl ist irreversibel, und alle mit dem Benutzerkontext verbundenen Speicher werden dauerhaft gelöscht.
Syntax
{
"method": "browser.removeUserContext",
"params": {
"userContext": "<userContextId>"
}
}
Parameter
Das params Feld enthält:
userContext-
Ein String, der die ID (UUID) des zu entfernenden Benutzerkontexts enthält. Benutzerkontext-IDs werden von Befehlen wie
browser.createUserContextoderbrowser.getUserContextszurückgegeben. Der Standard-Benutzerkontext ("default") kann nicht entfernt werden.
Rückgabewert
Das result Feld in der Antwort ist ein leeres Objekt ({}).
Fehler
invalid argument-
Das
userContextFeld ist"default". Der Standard-Benutzerkontext kann nicht entfernt werden. no such user context-
Es wird kein Benutzerkontext mit der angegebenen Benutzerkontext-ID gefunden.
Beispiele
Entfernen eines Benutzerkontexts
Betrachten Sie ein Szenario, in 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