devtools.panels.create()

Ajoute un nouveau panneau aux devtools.

Cette fonction prend : un titre, une URL vers un fichier d'ic√īne et une URL vers un fichier HTML. Il cr√©e un nouveau panneau dans les devtools, dont le contenu est sp√©cifi√© par le fichier HTML. Il renvoie une Promise qui r√©sout un objet ExtensionPanel repr√©sentant le nouveau panneau.

Syntaxe

var creating = browser.devtools.panels.create(
  title,       // string
  iconPath,    // string
  pagePath     // string
)

Parametères

title
string. Le titre du panneau. Cela apparaitra dans la rangée des onglets le long du haut de la fenêtre des devtools, et c'est la principale façon dont l'utilisateur pourra identifier votre panneau.
iconPath
string. Sp√©cifie une ic√īne qui sera affich√©e √† c√īt√© du titre. Il est fourni sous forme d'URL vers un fichier image qui a √©t√© fourni avec votre extension. L'URL est r√©solue par rapport √† la page d'extension courante (sauf si elle est exprim√©e en url absolue, par exemple "/icons/panel.png").
pagePath
string. Spécifie un fichier HTML qui définit le contenu réel du panneau. Il est fourni sous la forme d'une URL d'un fichier HTML qui a été regroupé avec votre extension. L'URL est résolue par rapport à la page d'extension courante (sauf si elle est exprimée en url absolue, par exemple "/devtools/panel.html"). Le fichier HTML peut include des fichiers CSS et JavaScript, juste comme une page web normale. Le JavaScript en cours d'éxécution dans le panneau pourra utiliser les API devtools. Voir Extention des outils de développement.

Valeur retournée

Une Promise qui sera remplie avec un objet ExtensionPanel représentant le nouveau panneau.

Compatibilité du navigateur

BCD tables only load in the browser

Exemples

Cr√©er un nouveau panneau, et ajoute des auditeurs √† ces √©v√©nements onShown et  onHidden :

function handleShown() {
  console.log("panel is being shown");
}

function handleHidden() {
  console.log("panel is being hidden");
}

browser.devtools.panels.create(
  "My Panel",                 // title
  "/icons/star.png",           // icon
  "/devtools/panel/panel.html" // content
).then((newPanel) => {
  newPanel.onShown.addListener(handleShown);
  newPanel.onHidden.addListener(handleHidden);
});

Remerciements

Cette API est basée sur l'API Chromium chrome.devtools.panels.

Les donn√©es de compatibilit√© relatives √† Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les √Čtats-Unis.