Modules

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 Promesse 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 la forme d'une URL d'un fichier image qui a été regroupé avec votre extension. L'URL doit être relative au fichier manifest.json lui-même.
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 doit être relative au fichier manifest.json lui-même. 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 Promesse qui sera remplie avec un objet ExtensionPanel représentant le nouveau panneau.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Basic supportYesNo54NoYes

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.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : hellosct1
 Dernière mise à jour par : hellosct1,