webNavigation

Fügen Sie Ereignis-Listener für die verschiedenen Phasen einer Navigation hinzu. Eine Navigation besteht aus einem Frame im Browser, der von einer URL zu einer anderen übergeht, normalerweise (aber nicht immer) als Reaktion auf eine Benutzeraktion wie das Klicken auf einen Link oder das Eingeben einer URL in die Adressleiste.

Verglichen mit der webRequest API: Navigationsereignisse führen in der Regel dazu, dass der Browser Webanfragen stellt, aber die webRequest API befasst sich mit der detaillierteren Ansicht auf der HTTP-Ebene, während die webNavigation API sich mehr mit der Ansicht aus der Benutzeroberfläche des Browsers selbst beschäftigt.

Jedes Ereignis entspricht einer bestimmten Phase der Navigation. Die Reihenfolge der Ereignisse sieht wie folgt aus:

• Der primäre Ablauf ist:

  • onBeforeNavigate
  • onCommitted
  • onDOMContentLoaded
  • onCompleted.

• Zusätzlich:

  • onCreatedNavigationTarget wird vor onBeforeNavigate ausgelöst, wenn der Browser ein neues Tab oder Fenster für die Navigation erstellen muss (zum Beispiel, weil der Benutzer einen Link in einem neuen Tab geöffnet hat).
  • onHistoryStateUpdated wird ausgelöst, wenn eine Seite die history API verwendet, um die in der Adressleiste des Browsers angezeigte URL zu aktualisieren.
  • onReferenceFragmentUpdated wird ausgelöst, wenn der Fragment-Identifier einer Seite geändert wird.
  • onErrorOccurred kann jederzeit ausgelöst werden.

Jede Navigation ist ein URL-Übergang in einem bestimmten Browser-Frame. Der Browser-Frame wird durch eine Tab-ID und eine Frame-ID identifiziert. Der Frame kann entweder der oberste Browsing-Kontext im Tab sein, oder ein verschachtelter Browsing-Kontext, der als iframe implementiert ist.

Jeder addListener()-Aufruf eines Ereignisses akzeptiert einen optionalen Filterparameter. Mit dem Filter können ein oder mehrere URL-Muster spezifiziert werden, und das Ereignis wird dann nur für Navigationen ausgelöst, bei denen die Ziel-URL einem der Muster entspricht.

Der onCommitted Ereignis-Listener erhält zwei zusätzliche Eigenschaften: einen TransitionType, der den Grund für die Navigation angibt (z. B. weil der Benutzer auf einen Link geklickt hat oder ein Lesezeichen ausgewählt hat), und einen TransitionQualifier, der weitere Informationen über die Navigation liefert.

Um diese API nutzen zu können, benötigen Sie die Berechtigung "webNavigation" permission.