browsingContext.activate-Befehl - WebDriver

Syntax

json

{
  "method": "browsingContext.activate",
  "params": {
    "context": "<contextId>"
  }
}

Parameter

Das params-Feld enthält:

context: Ein String, der die ID des Top-Level-Kontexts enthält, den Sie in den Vordergrund bringen und fokussieren möchten. 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 ebenfalls zurückgegeben, wenn der durch context angegebene Kontext kein Top-Level-Kontext ist.
no such frame: Kein Kontext mit der angegebenen Kontext-ID wurde gefunden.
unsupported operation: Der Browser kann den Kontext nicht in den Vordergrund bringen.

Beispiele

Aktivieren eines Hintergrund-Tabs

Das folgende Beispiel zeigt, wie ein Hintergrund-Tab aktiviert wird.

Mit einer WebDriver BiDi-Verbindung und einer aktiven Sitzung, nehmen wir an, Sie erstellen einen Tab im Hintergrund mit browsingContext.create mit background: true, welches 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