web api instance method

Navigation: entries() method

The entries() method of the Navigation interface returns an array of NavigationHistoryEntry objects representing all existing history entries.

Syntax

entries()

Parameters

None.

Return value

An array of NavigationHistoryEntry objects.

Exceptions

None.

Examples

Return the number of entries in the history

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

A smart back button

A page-supplied “back” button can take you back, even after reload, by inspecting the previous history entries:

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" });
  }
});

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.