browsingContext.activate-Befehl - WebDriver

Syntax

json

{
  "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.getTree zurü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 context angegebene 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:

json

{
  "id": 1,
  "method": "browsingContext.activate",
  "params": {
    "context": "5e5e96e8-5247-4f22-9b35-a4a2d841cbaa"
  }
}

Der Browser bringt den Tab in den Vordergrund und antwortet wie folgt:

json

{
  "id": 1,
  "type": "success",
  "result": {}
}

Spezifikationen

Spezifikation
WebDriver BiDi # command-browsingContext-activate

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