`browsingContext.navigationStarted` Ereignis

Das browsingContext.navigationStarted Ereignis des browsingContext-Moduls wird ausgelöst, wenn eine Navigation über Dokumentgrenzen hinweg in einem Kontext beginnt.

Ereignisdaten

Das params-Feld in der Ereignisbenachrichtigung ist ein Objekt mit den folgenden Feldern:

context: Ein String, der die ID des Kontexts enthält, in dem die Navigation beginnt.
navigation: Ein String, der die UUID enthält, die diese Navigation eindeutig identifiziert. Falls die Navigation mittels des Befehls browsingContext.navigate oder browsingContext.reload gestartet wurde, stimmt diese ID mit dem navigation-Wert in der Antwort des Befehls überein. Die gleiche ID wird von allen Ereignissen geteilt, die sich auf diese Navigation beziehen, einschließlich anderer Navigationsevents im browsingContext-Modul und Events im network-Modul.
timestamp: Eine nicht-negative Ganzzahl, die die Zeit repräsentiert, zu der das Ereignis ausgelöst wurde, in Millisekunden seit dem epoch.
url: Ein String, der die geladene URL enthält.

Die Navigation zu einer anderen Seite kann durch den Befehl browsingContext.navigate oder browsingContext.reload, durch Benutzerinteraktion mit Elementen auf der Seite oder durch JavaScript, das im Kontext der Seite ausgeführt wird, ausgelöst werden.

Für Navigationsvorgänge über Dokumentgrenzen hinweg ist dies das erste Ereignis in der Sequenz und wird ausgelöst, wenn der Browser beginnt, die URL zu laden. Wenn die Navigation erfolgreich ist, wird als Nächstes browsingContext.navigationCommitted ausgelöst, wenn der Browser die Antwort akzeptiert hat und mit dem Laden der neuen Seite beginnt. Danach wird browsingContext.domContentLoaded ausgelöst, wenn das HTML analysiert wurde, und browsingContext.load wird zuletzt ausgelöst, wenn das Dokument und alle seine untergeordneten Ressourcen vollständig geladen sind. Wenn die Navigation fehlschlägt, wird stattdessen browsingContext.navigationFailed ausgelöst.

Hinweis: Dieses Ereignis wird nicht ausgelöst, wenn die anfängliche about:blank-Seite für einen neuen obersten Browsing-Kontext geladen wird.

Dieses Ereignis wird nicht für identische Dokumentnavigationen ausgelöst. Für Navigationen zu einem URL-Fragment siehe browsingContext.fragmentNavigated. Für URL-Änderungen, die über die History API ohne vollständige Navigation vorgenommen werden, siehe browsingContext.historyUpdated.

Beispiele

Empfang eines Ereignisses, wenn eine Navigation über Dokumentgrenzen hinweg beginnt

Angenommen, Sie haben eine WebDriver BiDi-Verbindung und eine aktive Sitzung mit einem Abonnement für browsingContext.navigationStarted.

Angenommen, Sie verwenden browsingContext.navigate, um https://example.com zu laden und übergeben die Kontext-ID, die Sie von browsingContext.getTree erhalten haben.

Der Browser sendet folgende Benachrichtigung, wobei der context-Wert mit der Kontext-ID übereinstimmt, die Sie an browsingContext.navigate übergeben haben:

json

{
  "type": "event",
  "method": "browsingContext.navigationStarted",
  "params": {
    "context": "5e5e96e8-5247-4f22-9b35-a4a2d841cbaa",
    "navigation": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "timestamp": 1781646423959,
    "url": "https://example.com"
  }
}