Интерфейс XPathExpression

evaluate

Object evaluate(Node contextNode, short type, Object result) throws XPathException, DOMException

Параметры:

contextNode - Узел контекста для вычисления этого выражения XPath. Если XPathEvaluator был получен путём приведения типа Document, то этот узел должен принадлежать тому же документу и должен быть узлом типа Document, Element, Attribute, Text, CDATASection, Comment, ProcessingInstruction, или XPathNamespace. Если узел контекста является узлом Text или CDATASection, то контекст интерпретируется как весь логический текстовый узел, как видит XPath, за исключением случаев, когда узел пустой, в этом случае он не может служить контекстом XPath.

type - Если указан конкретный тип type, то результат будет приведён к указанному типу, используя преобразования XPath, и вызовет ошибку, если желаемое преобразование невозможно. Это должно быть одно из кодов типов XPathResult.

result - Объект result для возвращаемого результата, который может быть повторно использован. Если он указан как null, или реализация не использует указанный результат, будет создан и возвращён новый объект результата. Для результатов XPath 1.0 этот объект будет типа XPathResult.

Возвращает:

Результат вычисления выражения XPath. Для результатов XPath 1.0 этот объект будет типа XPathResult.

Исключения:

XPathException - TYPE_ERR: Возникает, если результат невозможно преобразовать в указанный тип.

DOMException - WRONG_DOCUMENT_ERR: Узел происходит из документа, который не поддерживается XPathEvaluator, создавшим этот XPathExpression .
NOT_SUPPORTED_ERR: Узел не является типом, разрешённым в качестве узла контекста XPath, или тип запроса не разрешён этим XPathExpression.