`browsingContext.navigationFailed`-Ereignis

Das browsingContext.navigationFailed-Ereignis des browsingContext-Moduls wird ausgelöst, wenn eine Navigation über Dokumentengrenzen hinweg blockiert wird.

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 fehlgeschlagen ist.
navigation: Ein String, der die UUID enthält, die diese Navigation eindeutig identifiziert. Wenn die Navigation mit dem Befehl browsingContext.navigate oder browsingContext.reload gestartet wurde, entspricht diese ID dem navigation-Wert in der Antwort des Befehls. Dieselbe ID wird von allen Ereignissen geteilt, die sich auf diese Navigation beziehen, einschließlich anderer Navigationsereignisse im browsingContext-Modul und Ereignissen im network-Modul.
timestamp: Eine nichtnegative Ganzzahl, die den Zeitpunkt darstellt, zu dem das Ereignis ausgelöst wurde, in Millisekunden seit dem Epoche.
url: Ein String, der die geladene URL enthält.

Im Lebenszyklus einer Navigation wird dieses Ereignis ausgelöst, wenn die Navigation blockiert wird, zum Beispiel aufgrund einer Sicherheits- oder CSP-Beschränkung oder weil der Client das Entladen-Abfragefenster abbricht.

Beispiele

Empfang eines Ereignisses, wenn eine Navigation über Dokumentengrenzen hinweg blockiert wird

Angenommen, Sie haben eine WebDriver BiDi-Verbindung und eine aktive Sitzung mit einem Abonnement für browsingContext.navigationFailed. Die unhandledPromptBehavior-Fähigkeit der Sitzung ist so konfiguriert, dass beforeunload-Abfragen verworfen werden. Die aktuelle Seite hat auch einen beforeunload-Handler, der event.preventDefault() aufruft, um vor dem Verlassen zu warnen.

Angenommen, es gibt nicht gespeicherte Änderungen auf dieser Seite und Sie verwenden browsingContext.navigate um eine andere URL zu laden.

Der Browser öffnet das beforeunload-Abfragefenster, löst ein browsingContext.navigationStarted-Ereignis aus und blockiert die Navigation. Der Browser sendet die folgende Benachrichtigung, wobei der context-Wert der Kontext-ID entspricht, die Sie browsingContext.navigate übergeben haben, und der navigation-Wert die ID der blockierten Navigation ist:

json

{
  "type": "event",
  "method": "browsingContext.navigationFailed",
  "params": {
    "context": "5e5e96e8-5247-4f22-9b35-a4a2d841cbaa",
    "navigation": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "timestamp": 1712345678901
  }
}