Méthode XML DOM evaluate()

Manuel de référence de l'objet Document

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.

Consulter

Manuel de référence de l'objet Document