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

This is an asynchronous function that returns a Promise.


var goingForward = browser.tabs.goForward(
  tabId,                       // optional integer
  callback                       // optional function


integer. The ID of the tab to navigate. Defaults to the active tab of the current window.
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

BCD tables only load in the browser


Go forward to the next page in the current tab:

function onGoForward() {
  console.log("Gone forward");

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

var goingForward = browser.tabs.goForward();
goingForward.then(onGoForward, onError);


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

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.