devtools.panels.ElementsPanel.setExpression()

Evalue une expression dans le contexte de la page inspectée et affiche le résultat dans le volet de la barre latérale d'extension.

Le contexte d'exécution de l'expression est le même que celui de inspectedWindow.eval().

Les objets JSON et les noeuds DOM sont affichés en tant qu'arborescence extensible, comme dans la visionneuse jSON dans Firefox. Vous pouvez éventuellement spécifier une chaîne rootTitle : elle sera affichée comme le titre de la racine de l'arbre.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

js
var evaluating = browser.devtools.panels.setExpression(
  expression, // string
  rootTitle, // string
);

Paramètres

expression

string. L'expression à évaluer.

rootTitle Facultatif

string. Le titre de la racine de l'arbre dans lequel les résultats sont affichés.

Valeur retournée

Une Promise sera remplie sans arguments, une fois l'expression évaluée.

Compatibilité des navigateurs

BCD tables only load in the browser

Exemples

Ce code crée un volet de barre latérale qui affiche le tagName de l'élément actuellement sélectionné :

js
function onCreated(sidebarPane) {
  browser.devtools.panels.elements.onSelectionChanged.addListener(() => {
    const exp = "$0 && $0.tagName";
    const title = "Selected Element tagName";
    sidebarPane.setExpression(exp, title);
  });
}

browser.devtools.panels.elements.createSidebarPane("My pane").then(onCreated);

Note :

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