Back to Content

History: scrollRestoration property

files/en-us/web/api/history/scrollrestoration/index.md

latest892 B
Original Source

{{APIRef("History API")}}

The scrollRestoration property of the {{DOMxRef("History")}} interface allows web applications to explicitly set default scroll restoration behavior on history navigation.

Value

One of the following:

  • auto
    • : The location on the page to which the user has scrolled will be restored.
  • manual
    • : The location on the page is not restored. The user will have to scroll to the location manually.

Examples

Query the current scroll restoration behavior

js
const scrollRestoration = history.scrollRestoration;
if (scrollRestoration === "manual") {
  console.log(
    "The location on the page is not restored, user will need to scroll manually.",
  );
}

Prevent automatic page location restoration

js
history.scrollRestoration = "manual";

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}