Add-ons

pageAction.show()

Shows the page action for a given tab. The page action is shown whenever the given tab is the active tab.

Syntax

browser.pageAction.show(
  tabId // integer
)

Parameters

tabId
integer. The ID of the tab for which you want to show the page action.

Return value

A Promise that will be fulfilled with undefined.

Browser compatibility

ChromeEdgeFirefoxFirefox for AndroidOpera
Basic support Yes Yes45501 Yes

1. Before version 56, the 'tabId' parameter was ignored, and the page action was shown for all tabs.

Examples

This example shows the page action for the active tab when the user selects a context menu item. Note that you'll need the contextMenus permission in your manifest to create context menu items.

browser.contextMenus.create({
  id: "show",
  title: "Show page action"
});

browser.contextMenus.onClicked.addListener(function(info, tab) {
  if (info.menuItemId == "show") {
    browser.pageAction.show(tab.id);
  }
});

Example extensions

Acknowledgements

This API is based on Chromium's chrome.pageAction API. This documentation is derived from page_action.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.

Document Tags and Contributors

 Contributors to this page: peter.kehl, wbamberg, Makyen, chrisdavidmills
 Last updated by: peter.kehl,