W3cubDocs

/Web APIs

Navigation: entries() method

Limited availability

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

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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

Specification
HTML> # dom-navigation-entries-dev>

Browser compatibility

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`entries`	102	102	No	88	No	102	No	70	No	19.0	102	No