action.openPopup()

Open the browser action's popup.

Note: This API is available in Manifest V3 or higher.

In stable versions of Firefox, you can only call this function from inside the handler for a user action. See Browser compatibility for details.

Syntax

js
browser.action.openPopup(
  options // optional object
)

Parameters

details Optional

An object with the following properties:

windowId Optional

integer. Window to open the popup for. Defaults to the current window.

Return value

A Promise that is resolved with no arguments.

Examples

Open the popup when the user selects a context menu item:

js
browser.menus.create({
  id: "open-popup",
  title: "open popup",
  contexts: ["all"],
});

browser.menus.onClicked.addListener(() => {
  browser.action.openPopup();
});

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
openPopup

Legend

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

Full support
Full support
See implementation notes.
Has more compatibility info.