NavigateEvent: NavigateEvent() Konstruktor

Baseline 2026

Newly available

Since January 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Der NavigateEvent() Konstruktor erstellt eine neue Instanz eines NavigateEvent-Objekts.

Syntax

new NavigateEvent(type, init)

Parameter

type

Ein String, der den Typ des Ereignisses darstellt.

init

Ein Objekt, das zusätzlich zu den im Event() definierten Eigenschaften die folgenden Eigenschaften enthält:

canIntercept Optional: Ein boolescher Wert, der definiert, ob die Navigation abgefangen werden kann oder nicht (z.B. kann eine cross-origin Navigation nicht abgefangen werden). Standardwert ist false.
destination: Ein NavigationDestination-Objekt, das den Ort darstellt, zu dem navigiert wird.
downloadRequest Optional: Der Dateiname der Datei, die im Falle einer Download-Navigation angefordert wird (z.B. ein <a> oder <area> Element mit einem download Attribut). Standardwert ist null.
formData Optional: Das FormData-Objekt, das die übermittelten Daten im Falle einer POST Formularübermittlung darstellt. Standardwert ist null.
hashChange Optional: Ein boolescher Wert, der definiert, ob die Navigation eine Fragmentnavigation ist (d.h. zu einem Fragment-Identifier im selben Dokument). Standardwert ist false.
hasUAVisualTransition Optional: Ein boolescher Wert, der definiert, ob der Benutzeragent eine visuelle Überblendung für diese Navigation durchgeführt hat, bevor dieses Ereignis ausgelöst wurde. Standardwert ist false.
info Optional: Der info-Datenwert, der von der auslösenden Navigationsoperation übergeben wurde (z.B. Navigation.back() oder Navigation.navigate()).
navigationType Optional: Der Typ der Navigation. Mögliche Werte — push, reload, replace und traverse. Standardwert ist push.
signal: Ein AbortSignal, das abgebrochen wird, wenn die Navigation abgebrochen wird (z.B. durch das Drücken der "Stopp"-Taste des Browsers durch den Nutzer oder wenn eine andere Navigation beginnt und somit die laufende abbricht).
sourceElement Optional: Ein Element-Objekt, das das auslösende Element darstellt, in Fällen in denen die Navigation von einem Element initiiert wurde, oder null, wenn die Navigation nicht von einem Element initiiert wurde. Standardwert ist null.
userInitiated Optional: Ein boolescher Wert, der definiert, ob die Navigation vom Nutzer initiiert wurde (z.B. durch Klicken auf einen Link, Absenden eines Formulars oder Drücken der "Zurück"/"Weiter"-Tasten des Browsers). Standardwert ist false.

Rückgabewert

Ein neues NavigateEvent-Objekt.

Beispiele

Ein Entwickler würde diesen Konstruktor nicht manuell verwenden. Ein neues NavigateEvent-Objekt wird erstellt, wenn ein Handler infolge des Auslösens des navigate-Ereignisses aufgerufen wird.

navigation.addEventListener("navigate", (event) => {
  // Exit early if this navigation shouldn't be intercepted,
  // e.g. if the navigation is cross-origin, or a download request
  if (shouldNotIntercept(event)) {
    return;
  }

  const url = new URL(event.destination.url);

  if (url.pathname.startsWith("/articles/")) {
    event.intercept({
      async handler() {
        // The URL has already changed, so show a placeholder while
        // fetching the new content, such as a spinner or loading page
        renderArticlePagePlaceholder();

        // Fetch the new content and display when ready
        const articleContent = await getArticleContent(url.pathname);
        renderArticlePage(articleContent);
      },
    });
  }
});

Spezifikationen

Specification
HTML # the-navigateevent-interface

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden