Navigation: `entries()` Methode

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.

Die entries() Methode der Navigation Schnittstelle gibt ein Array von NavigationHistoryEntry Objekten zurück, die alle vorhandenen Verlaufseinträge darstellen.

Syntax

js
entries()

Parameter

Keine.

Rückgabewert

Ein Array von NavigationHistoryEntry Objekten.

Ausnahmen

Keine.

Beispiele

Die Anzahl der Einträge im Verlauf zurückgeben

js
let numOfEntries = navigation.entries().length - 1;

Ein intelligenter Zurück-Button

Ein von der Seite bereitgestellter "Zurück"-Button kann Sie zurückbringen, sogar nach einem Neuladen, indem er die vorherigen Verlaufseinträge inspiziert:

js
backButtonEl.addEventListener("click", () => {
  if (
    navigation.entries()[navigation.currentEntry.index - 1]?.url ===
    "/product-listing"
  ) {
    navigation.back();
  } else {
    // If the user arrived here in some other way
    // e.g. by typing the URL directly:
    navigation.navigate("/product-listing", { history: "replace" });
  }
});

Spezifikationen

Specification
HTML Standard
# dom-navigation-entries-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch