History.go()
The History.go()
method loads a specific page from the
session history. You can use it to move forwards and backwards through the history
depending on the value of a parameter.
This method is asynchronous. Add a listener for the
popstate
event in order to determine when the navigation has completed.
Syntax
history.go([delta])
Parameters
delta
Optional-
The position in the history to which you want to move, relative to the current page. A negative value moves backwards, a positive value moves forwards. So, for example,
history.go(2)
moves forward two pages andhistory.go(-2)
moves back two pages. If no value is passed or ifdelta
equals 0, it has the same result as callinglocation.reload()
.
Examples
To move back one page (the equivalent of calling back()
):
history.go(-1)
To move forward a page, just like calling forward()
:
history.go(1)
To move forward two pages:
history.go(2);
To move backwards by two pages:
history.go(-2);
And, finally either of the following statements will reload the current page:
history.go();
history.go(0);
Specifications
Specification |
---|
HTML Standard # dom-history-go-dev |
Browser compatibility
BCD tables only load in the browser