Firefox Tomorrow

web api instance method

Navigation: back() method

View on MDN ↗

The back() method of the Navigation interface navigates backwards by one entry in the navigation history.

Syntax

back(options)

Parameters

  • options Optional
    • : An options object containing the following properties:
      • info Optional
        • : Developer-defined information to be passed along to the navigate event, made available in info. This can be any data type. You might, for example, wish to display newly-navigated content with a different animation depending on how it was navigated to (swipe left, swipe right, or go home). A string indicating which animation to use could be passed in as info.

Return value

An object with the following properties:

  • committed
  • finished
    • : A Promise which will fulfill when all promises returned by the intercept() handler are fulfilled. This is equivalent to the finished promise fulfilling, when the navigatesuccess event fires.

Either one of these promises rejects if the navigation has failed for some reason.

Exceptions

  • InvalidStateError DOMException
    • : Thrown if the currentEntry’s index value is -1 or 0, i.e., either the current Document is not yet active, or the current history entry is the first one in the history, meaning that backwards navigation is not possible, or if the current Document is unloading.

Examples

async function backHandler() {
  if (navigation.canGoBack) {
    await navigation.back().finished;
    // Handle any required clean-up after
    // navigation has finished
  } else {
    displayBanner("You are on the first page");
  }
}

async function forwardHandler() {
  if (navigation.canGoForward) {
    await navigation.forward().finished;
    // Handle any required clean-up after
    // navigation has finished
  } else {
    displayBanner("You are on the last page");
  }
}

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also