W3cubDocs

/Web Extensions

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

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.

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
isShown
No
No
59
?
No
No
?
?
No
?
?
?

Examples

Check the state of the currently active tab:

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);
}

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/pageAction/isShown