Add-ons

tabs.show()

Note that this currently an experimental API: it may be changed or removed at any time.

It is only supported in Firefox and is disabled by default. To enable it, visit about:config and set "extensions.webextensions.tabhide.enabled" to true.

Shows one or more tabs that were previously hidden by a call to tabs.hide.

This is an asynchronous function that returns a Promise.

Syntax

var showing = browser.tabs.show(
  tabIds          // integer or integer array
)

Parameters

tabIds
integer or array of integer. The IDs of the tab or tabs to show.

Return value

A Promise that will be fulfilled with no arguments. If any error occurs, the promise will be rejected with an error message.

Browser compatibility

No compatibility data found. Please contribute data for "webextensions.api.tabs.show" (depth: 1) to the MDN compatibility data repository.

Examples

Show a single tab:

function onShown() {
  console.log(`Shown`);
}

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

browser.tabs.show(2).then(onShown, onError);

Show multiple tabs:

function onShown() {
  console.log(`Shown`);
}

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

browser.tabs.show([15, 14, 1]).then(onShown, onError);

Document Tags and Contributors

 Contributors to this page: wbamberg
 Last updated by: wbamberg,