NavigateEvent: NavigateEvent() Konstruktor - Web-APIs | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

NavigateEvent: NavigateEvent() Konstruktor

Baseline 2026

Neu verfügbar

Seit January 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

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

In diesem Artikel

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.

js
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);
      },
    });
  }
});

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

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

Navigation API
NavigateEvent
Konstruktor
1. NavigateEvent()
Instanzeigenschaften
Instanzmethoden
1. intercept()
2. scroll()
Vererbung
1. Event
Verwandte Seiten für Navigation API