action.getPopup()

Ruft das HTML-Dokument ab, das als Popup für diese Browseraktion festgelegt ist.

Hinweis: Diese API ist in Manifest V3 oder höher verfügbar.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let gettingPopup = browser.action.getPopup(
  details               // object
)

Parameter

details

Ein Objekt mit den folgenden Eigenschaften:

tabId Optional

integer. Die Registerkarte, deren Popup abgerufen werden soll.

windowId Optional

integer. Das Fenster, dessen Popup abgerufen werden soll.

  • Wenn sowohl windowId als auch tabId angegeben sind, schlägt die Funktion fehl.
  • Wenn sowohl windowId als auch tabId weggelassen werden, wird das globale Popup zurückgegeben.

Rückgabewert

Ein Promise, das mit einem String erfüllt wird, der die URL des Dokuments des Popups enthält. Dies wird eine vollständig qualifizierte URL sein, wie z.B. moz-extension://d1d8a2eb-fe60-f646-af30-a866c5b39942/popups/popup2.html.

Beispiele

Abrufen der URL des Popups:

js
function gotPopup(popupURL) {
  console.log(popupURL);
}

let gettingPopup = browser.action.getPopup({});
gettingPopup.then(gotPopup);

Browser-Kompatibilität

BCD tables only load in the browser

Hinweis: Diese API basiert auf Chromium's chrome.action API. Diese Dokumentation ist abgeleitet von browser_action.json im Chromium-Code.