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

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é du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui1 Non572 Non Oui

1. The expression must evaluate to a JavaScript object or a DOM node, or nothing is shown in the sidebar.

2. The expression must evaluate to an object that can be serialized to JSON, or nothing is shown in the sidebar. In particular, JavaScript cyclic objects and DOM nodes are not supported. See bug 1403130.

Exemples

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

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);

Acknowledgements

This API is based on Chromium's chrome.devtools.panels API.

Étiquettes et contributeurs liés au document

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