History.scrollRestoration

The scrollRestoration property of History interface allows web applications to explicitly set default scroll restoration behavior on history navigation.

Value

One of the followings:

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.

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

if (history.scrollRestoration) {
  history.scrollRestoration = 'manual';
}

Specifications

Specification
HTML Standard # dom-history-scroll-restoration-dev

Browser compatibility

BCD tables only load in the browser