Firefox Tomorrow

web api instance method

History: forward() method

View on MDN ↗

The forward() method of the History interface causes the browser to move forward one page in the session history. It has the same effect as calling history.go(1).

This method is asynchronous. Add a listener for the popstate event in order to determine when the navigation has completed.

Syntax

forward()

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 examples create a button that moves forward one step in the session history.

HTML

<button id="go-forward">Go Forward!</button>

JavaScript

document.getElementById("go-forward").addEventListener("click", (e) => {
  history.forward();
});

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also