browsingContext.activate-Befehl
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Der browsingContext.activate-Befehl des browsingContext-Moduls bringt einen Top-Level-Kontext in den Vordergrund und fokussiert ihn.
Syntax
{
"method": "browsingContext.activate",
"params": {
"context": "93ee5bd6-d256-4608-a002-9a8995cc0e5f"
}
}
Parameter
Das params-Feld enthält:
context-
Ein String, der die ID des Top-Level-Kontexts enthält, der in den Vordergrund gebracht und fokussiert werden soll. Kontext-IDs werden von Befehlen wie
browsingContext.getTreezurückgegeben.
Rückgabewert
Das result-Feld in der Antwort ist ein leeres Objekt ({}).
Fehler
invalid argument-
Ein erforderlicher Parameter fehlt oder hat einen ungültigen Typ. Dieser Fehler wird auch zurückgegeben, wenn der durch
contextangegebene Kontext kein Top-Level-Kontext ist. no such frame-
Kein Kontext mit der angegebenen Kontext-ID wird gefunden.
unsupported operation-
Der Browser kann den Kontext nicht in den Vordergrund bringen.
Beispiele
Aktivierung eines Hintergrund-Tabs
Das folgende Beispiel zeigt, wie ein Hintergrund-Tab aktiviert wird.
Bei einer WebDriver BiDi-Verbindung und einer aktiven Sitzung nehmen wir an, dass Sie einen Tab im Hintergrund mit browsingContext.create und background: true erstellen, was die Kontext-ID des Tabs zurückgibt. Senden Sie die folgende Nachricht, um ihn zu aktivieren:
{
"id": 1,
"method": "browsingContext.activate",
"params": {
"context": "5e5e96e8-5247-4f22-9b35-a4a2d841cbaa"
}
}
Der Browser bringt den Tab in den Vordergrund und antwortet wie folgt:
{
"id": 1,
"type": "success",
"result": {}
}
Spezifikationen
| Spezifikation |
|---|
| WebDriver BiDi # command-browsingContext-activate |
Browser-Kompatibilität
Siehe auch
browsingContext.close-BefehlbrowsingContext.create-BefehlbrowsingContext.getTree-Befehl