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.