`browsingContext.navigationCommitted`-Ereignis

Das browsingContext.navigationCommitted Ereignis des browsingContext-Moduls wird ausgelöst, wenn der Browser eine Navigation über Dokumentengrenzen hinweg festschreibt und beginnt, die neue Seite zu laden.

Ereignisdaten

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

context: Ein String, der die ID des Kontexts enthält, in dem die Navigation festgeschrieben wird.
navigation: Ein String, der die UUID enthält, die diese Navigation eindeutig identifiziert. Wenn die Navigation mit dem browsingContext.navigate oder browsingContext.reload-Befehl gestartet wurde, stimmt diese ID mit dem navigation-Wert in der Befehlsantwort überein. Die gleiche ID wird von allen mit dieser Navigation verbundenen Ereignissen geteilt, einschließlich anderer Navigationsergebnisse im browsingContext-Modul und Ereignissen im network-Modul.
timestamp: Eine nicht-negative Ganzzahl, die die Zeit repräsentiert, zu der das Ereignis ausgelöst wurde, als Millisekunden, die seit der Epoche vergangen sind.
url: Ein String, der die geladene URL einschließlich etwaiger Basis-Auth-Anmeldeinformationen enthält.

Beschreibung

Eine Navigation wird festgeschrieben, wenn der Browser die URL von der Serverantwort akzeptiert hat und beginnt, die neue Seite zu laden, aber bevor irgendein Inhalt analysiert oder gerendert wurde. Der Seiteninhalt ist zu diesem Zeitpunkt noch nicht verfügbar.

Im Lebenszyklus einer erfolgreichen Navigation wird dieses Ereignis nach browsingContext.navigationStarted und vor den Ereignissen browsingContext.domContentLoaded und browsingContext.load ausgelöst.

Wenn Sie wait auf "none" für die Befehle browsingContext.navigate und browsingContext.reload setzen, kehren diese zurück, sobald browsingContext.navigationCommitted ausgelöst wird.

Dieses Ereignis wird nicht bei Navigationen im gleichen Dokument 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 über Dokumentengrenzen hinweggehende Navigation festgeschrieben wird

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

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

Der Browser löst zuerst ein browsingContext.navigationStarted-Ereignis aus (Sie erhalten diese Benachrichtigung nicht, da das Abonnement in diesem Beispiel nur für browsingContext.navigationCommitted ist).

Sobald der Browser die Serverantwort akzeptiert und das Laden der Seite festschreibt, sendet er die folgende Benachrichtigung, wobei der context-Wert mit der von Ihnen an browsingContext.navigate übergebenen Kontext-ID übereinstimmt:

json

{
  "type": "event",
  "method": "browsingContext.navigationCommitted",
  "params": {
    "context": "9f271a75-04b2-4b35-80cc-e22427d446fc",
    "navigation": "dc716296-7076-4ec0-b446-51c6fb5fefe8",
    "timestamp": 1781715436774,
    "url": "https://example.com"
  }
}