pageAction.isShown()

Returns true if the page action is being shown for the given tab.

This is an asynchronous function that returns a Promise.

Syntax

js
let gettingIsShown = browser.pageAction.isShown(
  details // object
)

Parameters

details

object. An object containing the tabId to check.

tabId

integer. ID of the tab to check.

Return value

A Promise that will be fulfilled with true if the extension's page action is being shown for the given tab, and false otherwise.

Examples

Check the state of the currently active tab:

js
async function shownInActiveTab() {
  let tabs = await browser.tabs.query({
    currentWindow: true,
    active: true,
  });
  let shown = await browser.pageAction.isShown({
    tabId: tabs[0].id,
  });
  console.log(shown);
}

Browser compatibility

desktop mobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
isShown
Chrome – No support
Chrome
footnote No support
Edge – No support
Edge
footnote No support
Firefox – Full support
Firefox 59 (Release date: 2018-03-13)
footnote Full support
Opera – No support
Opera
footnote No support
Safari – No support
Safari
footnote No support
Firefox for Android – Full support
Firefox for Android 79 (Release date: 2020-07-28)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote No support

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support