History: back() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The back()
method of the History
interface causes
the browser to move back one page in the session history.
It has the same
effect as calling history.go(-1)
. If there is no previous
page, this method call does nothing.
This method is asynchronous. Add a listener for the
popstate
event in order to determine when the navigation has completed.
Syntax
back()
Parameters
None.
Return value
None (undefined
).
Exceptions
SecurityError
DOMException
-
Thrown if the associated document is not fully active. Browsers also throttle navigations and may throw this error, generate a warning, or ignore the call if it's called too frequently.
Examples
The following short example causes a button on the page to navigate back one entry in the session history.
HTML
<button id="go-back">Go back!</button>
JavaScript
document.getElementById("go-back").addEventListener("click", () => {
history.back();
});
Specifications
Specification |
---|
HTML # dom-history-back-dev |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
back |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support