NavigateEvent: NavigateEvent() Konstruktor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Der NavigateEvent() Konstruktor erstellt eine neue Instanz des 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 besitzt:

canIntercept Optional: Ein Boolean, der definiert, ob die Navigation abgefangen werden kann oder nicht (z.B. kann man eine Navigation über verschiedene Ursprünge nicht abfangen). Standardwert ist false.
destination: Ein NavigationDestination Objekt, das den Zielort der Navigation darstellt.
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 Boolean, der definiert, ob es sich bei der Navigation um eine Fragmentnavigation handelt (d.h. zu einem Fragmentbezeichner im selben Dokument). Standardwert ist false.
hasUAVisualTransition Optional: Ein Boolean, der definiert, ob der User-Agent eine visuelle Transition für diese Navigation durchgeführt hat, bevor dieses Ereignis ausgelöst wurde. Standardwert ist false.
info Optional: Der info Datenwert, der von der initiierten 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 im Browser oder durch das Starten einer anderen Navigation, die somit die laufende abbricht).
sourceElement Optional: Ein Element Objekt, das das auslösende Element darstellt, wenn die Navigation von einem Element initiiert wurde, oder null, wenn die Navigation nicht von einem Element initiiert wurde. Standardwert ist null.
userInitiated Optional: Ein Boolean, der definiert, ob die Navigation vom Benutzer initiiert wurde (z.B. durch Klicken auf einen Link, das Absenden eines Formulars oder das Drücken der "Zurück"/"Vorwärts"-Tasten im Browser). 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 als Ergebnis des Feuerns 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