Document : méthode createExpression()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode createExpression() de l'interface Document compile une expression XPathExpression qui peut ensuite être utilisée pour des évaluations (répétées).
Cette méthode doit être appelée sur le même document que celui sur lequel on exécutera l'expression.
Syntaxe
js
createExpression(xpathText, namespaceURLMapper)
Paramètres
xpathText-
Une chaîne de caractères qui est l'expression XPath à compiler.
namespaceURLMapper-
Une fonction qui fait correspondre un préfixe d'espace de noms à une URL d'espace de noms (ou
nullsi aucune correspondance est nécessaire).
Valeur de retour
Un objet XPathExpression.
Exemples
js
const xpathExpr = document.createExpression("//div");
const xpathResult = xpathExpr.evaluate(document); // retourne un objet XPathResult
const nodeContext = document.querySelector("nav");
// Réutilise l'expression XPathExpression "xpathExpr"
const otherResult = xpathExpr.evaluate(nodeContext); // retourne un objet XPathResult
Spécifications
| Specification |
|---|
| DOM # dom-xpathevaluatorbase-createexpression |
Compatibilité des navigateurs
Voir aussi
- La méthode
Document.evaluate() - L'interface
XPathExpression