XML DOM evaluate() メソッド
定義と用法
evaluate() メソッドは XPath 表現を計算します。
文法：
evaluate(xpathText,contextNode,namespaceURLMapper,resultType,result)
| パラメータ | 説明 |
|---|---|
| xpathText | 計算されるべき XPath 表現を表す文字列。 |
| contextNode | 文書内の、計算されるべき表現に対応するノード。 |
| namespaceURLMapper |
名前空間プレフィックスを完全な名前空間 URL にマッピングする関数。 このようなマッピングが必要でない場合は null です。 |
| resultType |
期待される結果オブジェクトの型を指定し、XPath 変換を使用して結果の型を強制します。 の型の可能性は XPathResult オブジェクトが定義する定数です。 |
| result |
一つのリサイクル可能な XPathResult オブジェクト； 新しい XPathResult オブジェクトを作成する場合は null です。 |
返り値を表します。
が与えられた Context ノードを基に計算された XPathResult オブジェクト。
投げ出す
もし xpathText 文法エラーが含まれている場合、または表現の結果が期待される形式に変換できない場合 resultType、または表現にネームスペースが含まれている場合 namespaceURLMapper ネームスペースが解釈できない場合、または contextNode 誤ったタイプを持っている場合や、このドキュメントに関連していない場合、このメソッドは例外を投げます。
説明
このメソッドは指定された Context ノードに基づいて指定された XPath 表現を計算し、結果として XPathResult オブジェクトを返します。このオブジェクトの type は、結果のタイプがどのようなものであるべきかを決定します。一つの表現を複数回計算したい場合は、 Document.createExpression() を表現をコンパイルするために XPathExpression オブジェクト、次に XPathExpression の evaluate() メソッドを使用します。
IE はこの API をサポートしていません。参照 Node.selectNodes() および Node.selectSingleNode() 特定の IE に対応する代替方法について学びます。
