sidebarAction.getPanel()

Ruft eine URL des HTML-Dokuments ab, das den Inhalt der Seitenleiste definiert.

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

Syntax

js
let gettingPanel = browser.sidebarAction.getPanel(
  details               // object
)

Parameter

details

object. Ein Objekt mit den folgenden Eigenschaften:

tabId Optional

integer. Ruft das Panel für die Seitenleiste ab, das spezifisch für den angegebenen Tab ist.

windowId Optional

integer. Ruft das Panel für die Seitenleiste ab, das spezifisch für das angegebene Fenster ist.

  • Wenn sowohl windowId als auch tabId angegeben sind, schlägt die Funktion fehl und das von ihr zurückgegebene Promise wird verworfen.
  • Wenn sowohl windowId als auch tabId weggelassen werden, wird das globale Panel zurückgegeben.

Rückgabewert

Ein Promise, das mit einem String erfüllt wird, der die URL des Panel-Dokuments enthält. Dies wird eine voll qualifizierte URL sein, wie zum Beispiel:

url
moz-extension://d1d8a2eb-fe60-f646-af30-a866c5b39942/sidebar.html

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Abrufen der URL des Panels:

js
function onGot(sidebarUrl) {
  console.log(sidebarUrl);
}

let gettingPanel = browser.sidebarAction.getPanel({});
gettingPanel.then(onGot);

Hinweis: Diese API basiert auf der Opera-API chrome.sidebarAction.