index.md

---

title: tabs.goBack()
slug: Mozilla/Add-ons/WebExtensions/API/tabs/goBack
page-type: webextension-api-function
tags:
  - API
  - Add-ons
  - Extensions
  - Method
  - Non-standard
  - Reference
  - WebExtensions
  - goBack
browser-compat: webextensions.api.tabs.goBack

---

{{AddonSidebar()}}

Navigate to the previous page in tab's history, if available.

This is an asynchronous function that returns a Promise.

Syntax

let withGoingBack = browser.tabs.goBack(
  tabId,                  // optional integer
  callback                  // optional function
)

Parameters

• tabId {{optional_inline}}

  • : integer. The ID of the tab to navigate. Defaults to the active tab of the current window.

• callback {{optional_inline}}

  • : function. When the page navigation finishes, this function is called without parameters.

Return value

A Promise that is fulfilled when the page navigation finishes.

Browser compatibility

{{Compat}}

Examples

Go back to the previous page in the current tab:

function onGoBack() {
  console.log("Gone back");
}

function onError(error) {
  console.log(`Error: ${error}`);
}

let goingBack = browser.tabs.goBack();
goingBack.then(onGoBack, onError);

{{WebExtExamples}}

Note: This API is based on Chromium's chrome.tabs API. This documentation is derived from tabs.json in the Chromium code.