Méthode XML DOM evaluate()
Définition et utilisation
La méthode evaluate() calcule une expression XPath.
Grammaire :
evaluate(xpathText,contextNode,namespaceURLMapper,resultType,result)
paramètres | Description |
---|---|
xpathText | une chaîne représentant l'expression XPath à calculer. |
contextNode | noeud dans le document, correspondant à l'expression à calculer. |
namespaceURLMapper |
une fonction qui mappe un préfixe de nom d'espace vers une URL de nom d'espace complet. si ce type de mappage n'est pas nécessaire, il est null. |
resultType |
spécifie le type d'objet attendu comme résultat, en utilisant la transformation XPath pour forcer le type de résultat. les valeurs possibles du type result sont les constantes définies par l'objet XPathResult. |
result |
un objet XPathResult réutilisable ; si vous devez créer un nouveau XPathResult, il est null. |
valeur de retour
représente une valeur de retour calculée pour une expression donnée dans le Contexte du noeud. un objet XPathResult。
lance
si xpathText Contient des erreurs de syntaxe ou si le résultat de l'expression ne peut pas être converti en le résultat souhaité. resultTypeOu si l'expression contient namespaceURLMapper L'espace de noms non résolu, ou si contextNode Elle lève une exception si elle a un type incorrect ou s'il n'est pas pertinent pour ce document.
Description
Cette méthode calcule l'expression XPath spécifiée en fonction du nœud Context fourni et retourne un objet XPathResult, dont le type détermine le type de résultat à être déterminé. Si vous souhaitez calculer une expression plusieurs fois, utilisez Document.createExpression() Pour compiler l'expression en Objet XPathExpressionPuis utilisez la méthode evaluate() de XPathExpression.
IE ne prend pas en charge cet API. Consulter Node.selectNodes() Et Node.selectSingleNode() Pour comprendre une méthode alternative spécifique à IE.