History: scrollRestoration property

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{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}}