W3cubDocs

/Web APIs

Navigation: entries() method

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

js

entries()

Parameters

None.

Return value

An array of NavigationHistoryEntry objects.

Exceptions

None.

Examples

Return the number of entries in the history

js

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:

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

Specifications

Specification
HTML Standard
# dom-navigation-entries-dev

Browser compatibility

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

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Navigation/entries