browsingContext.traverseHistory-Befehl

Syntax

{
  "method": "browsingContext.traverseHistory",
  "params": {
    "context": "<contextId>",
    "delta": <integer>
  }
}

Parameter

Das params-Feld enthält:

context

Ein String, der die ID des Top-Level-Kontexts enthält, dessen Sitzungsverlauf navigiert werden soll. Kontext-IDs werden von Befehlen wie browsingContext.getTree zurückgegeben.

delta

Ein Integer, der die Anzahl der Verlaufs-Einträge angibt, die im Sitzungsverlauf bewegt werden sollen. Ein positiver Wert bewegt den Kontext vorwärts im Verlauf; ein negativer Wert bewegt ihn rückwärts.

Rückgabewert

Das result-Feld in der Antwort ist ein leeres Objekt ({}). Der Befehl gibt zurück, sobald die Navigation in die Warteschlange gestellt wurde, noch bevor die resultierende Navigation abgeschlossen ist. Das browsingContext.historyUpdated-Ereignis wird ausgelöst, wenn die Navigation abgeschlossen ist.

Fehler

invalid argument

Ein erforderlicher Parameter fehlt oder hat einen ungültigen Typ. Dieser Fehler wird auch zurückgegeben, wenn der angegebene context kein Top-Level-Kontext ist.

no such frame

Kein Kontext mit der angegebenen Kontext-ID gefunden.

no such history entry

Die durch delta angegebene Position im Sitzungsverlauf existiert nicht.

Beispiele

Im Verlauf zurück navigieren

Angenommen, Sie haben eine WebDriver BiDi-Verbindung und eine aktive Sitzung.

Angenommen, Sie haben einen Tab mit browsingContext.create erstellt und ihn über mehrere Seiten mit browsingContext.navigate navigiert: von https://example.com/page1.html zu https://example.com/page2.html und dann zu https://example.com/page3.html. Um zwei Verlaufs-Einträge zurück zu navigieren, also https://example.com/page2.html zu überspringen und bei https://example.com/page1.html zu landen, senden Sie die folgende Nachricht:

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

Der Browser stellt die Verlauf-Navigation in die Warteschlange und antwortet wie folgt:

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

Im Verlauf vorwärts navigieren

Fortsetzung des vorherigen Beispiels: Um einen Verlaufs-Eintrag vorwärts zu navigieren und bei https://example.com/page2.html zu landen, senden Sie die folgende Nachricht:

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

Der Browser stellt die Verlauf-Navigation in die Warteschlange und antwortet wie folgt:

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• browsingContext.navigate-Befehl
• browsingContext.reload-Befehl
• browsingContext.create-Befehl
• browsingContext.getTree-Befehl
• browsingContext.navigationStarted-Ereignis
• browsingContext.navigationCommitted-Ereignis
• browsingContext.navigationFailed-Ereignis
• browsingContext.historyUpdated-Ereignis