From 3aacbc5024ca80a97ef6ce0ad1fe654f36bf45b1 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 28 Dec 2021 14:25:46 +0900 Subject: 2021/10/09 時点の英語版に同期 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../index.md | 466 +++++++++------------ 1 file changed, 203 insertions(+), 263 deletions(-) diff --git a/files/ja/web/xpath/introduction_to_using_xpath_in_javascript/index.md b/files/ja/web/xpath/introduction_to_using_xpath_in_javascript/index.md index b1d275a984..f3fa2bda26 100644 --- a/files/ja/web/xpath/introduction_to_using_xpath_in_javascript/index.md +++ b/files/ja/web/xpath/introduction_to_using_xpath_in_javascript/index.md @@ -1,5 +1,5 @@ --- -title: JavaScript での XPath の 利用 +title: JavaScript での XPath の利用の手引き slug: Web/XPath/Introduction_to_using_XPath_in_JavaScript tags: - Add-ons @@ -13,128 +13,121 @@ tags: - XSLT original_slug: Introduction_to_using_XPath_in_JavaScript --- -

この文書では拡張機能やウェブサイトから JavaScript 内で XPath を使うためのインターフェイスについて解説します。 Mozilla は DOM 3 XPath のかなりの部分を実装しており、 HTML 文書と XML 文書のどちらに対しても XPath 式を実行することができます。

+この文書では、拡張機能やウェブサイトから JavaScript 内で [XPath](/ja/docs/Web/XPath) を使うためのインターフェイスについて解説します。 Mozilla は [DOM 3 XPath](https://www.w3.org/TR/DOM-Level-3-XPath/xpath.html) のかなりの部分を実装しており、 HTML 文書と XML 文書のどちらに対しても XPath 式を実行することができます。 -

XPath を使用するための主となるインターフェイスは document オブジェクトの evaluate 関数です。

+XPath を使用するための主となるインターフェイスは [document](/ja/docs/Web/API/Document) オブジェクトの [evaluate](/ja/docs/Web/API/Document/evaluate) 関数です。 -

document.evaluate

+## document.evaluate -

このメソッドは XPath 式を XML ベースの文書 ( HTML を含む) に対して評価し、 XPathResult オブジェクトを返します。 XPathResult オブジェクトは単一のノード、もしくはノードの集合になります。既存のこのメソッドのドキュメントは document.evaluate ですが、このメソッドの解説のためには内容が薄いため、以下でさらに詳しく説明します。

+このメソッドは [XPath](/ja/docs/Web/XPath) 式を [XML](/ja/docs/Glossary/XML) ベースの文書 ( HTML を含む) に対して評価し、 [`XPathResult`](/ja/docs/Web/API/XPathResult) オブジェクトを返します。これは単一のノード、もしくはノードの集合になります。このメソッドの既存のドキュメントは [document.evaluate](/ja/docs/Web/API/Document/evaluate) ですが、このメソッドの解説のためには内容が薄いため、以下でさらに詳しく説明します。 -
var xpathResult = document.evaluate( xpathExpression, contextNode, namespaceResolver, resultType, result );
-
+```js +var xpathResult = document.evaluate( xpathExpression, contextNode, namespaceResolver, resultType, result ); +``` -

引数

+### 引数 -

evaluate 関数は 5 つの引数を取ります。

+[evaluate](/ja/docs/Web/API/Document/evaluate) 関数は 5 つの引数を取ります。 - + - [`XPathEvaluator`](http://www.xulplanet.com/references/objref/XPathEvaluator.html) オブジェクトの [`createNSResolver`](/ja/docs/Web/API/Document/createNSResolver) メソッドにより[作成された](#既定の名前空間リゾルバーの実装)もの。ほとんどの場合はこれを使うべきでしょう。 + - HTML 文書の場合や、名前空間接頭辞が使われていない場合は `null`。 `xpathExpression` に名前空間接頭辞が含まれている場合は、 `DOMException` が `NAMESPACE_ERR` のコードで発生するので注意してください。 + - ユーザー定義のカスタム関数。詳しくは付録の[ユーザー定義名前空間リゾルバーの使用](#ユーザー定義の名前空間リゾルバーの実装)の節を参照してください。 -

返値

+- `resultType`: 評価の結果返してほしい値の型を示す[定数](#xpathresult_の定義済み定数)です。もっともよく指定される定数は `XPathResult.ANY_TYPE` で、この場合、指定された XPath 式に対して一番適切な型で結果が返されます。指定できる定数の一覧は付録の[定数一覧](#xpathresult_の定義済み定数)の節を参照してください。それぞれの定数の使い方は「[返値の型の指定](#返値の型の指定)」の節を参考にしてください。 +- `result`: 既存の `XPathResult` オブジェクトが指定された場合には、そのオブジェクトが再利用されます。 `null` が指定された場合は、新しい `XPathResult` オブジェクトが生成されます。 -

xpathResult を返します。これは引数 resultType で指定された型の XPathResult オブジェクトです。XPathResult インターフェイスはここで定義されています。

+### 返値 -

既定の名前空間リゾルバーの実装

+`xpathResult` を返します。これは引数 `resultType` で[指定された](#返値の型の指定)の `XPathResult` 型のオブジェクトです。`XPathResult` インターフェイスは[ここ](/ja/docs/Web/API/XPathResult)で定義されています。 -

名前空間リゾルバーを作成するには、普通は document オブジェクトの createNSResolver メソッドを使います。

+### 既定の名前空間リゾルバーの実装 -
var nsResolver = document.createNSResolver( contextNode.ownerDocument == null ? contextNode.documentElement : contextNode.ownerDocument.documentElement );
-
+名前空間リゾルバーを作成するには、普通は [document](/ja/docs/Web/API/Document) オブジェクトの `createNSResolver` メソッドを使います。 -

または、 XPathEvaluator オブジェクトの createNSResolver メソッドを使います。

-
var xpEvaluator = new XPathEvaluator();
+```js
+var nsResolver = document.createNSResolver( contextNode.ownerDocument == null ? contextNode.documentElement : contextNode.ownerDocument.documentElement );
+```
+
+または、 `XPathEvaluator` オブジェクトの `createNSResolver` メソッドを使います。
+
+```js
+var xpEvaluator = new XPathEvaluator();
 var nsResolver = xpEvaluator.createNSResolver( contextNode.ownerDocument == null ? contextNode.documentElement : contextNode.ownerDocument.documentElement );
-
+``` -それから 変数 nsResolver を引数 namespaceResolver として document.evaluate に渡します。

+それから 変数 `nsResolver` を引数 `namespaceResolver` として `document.evaluate` に渡します。 -

注: XPath では接頭辞のない QName は名前空間が null の要素にのみ一致すると定義しています。 XPath には、通常の要素参照に適用される既定の名前空間を取得する手段はありません。 (例: xmlns='http://www.w3.org/1999/xhtml' に対する p[@id='_myid'])。名前空間が null ではない既定の要素に一致させるには、 ['namespace-uri()='http://www.w3.org/1999/xhtml' and name()='p' and @id='_myid'] のような形を使用して特定の要素を参照するか (このアプローチは名前空間が不明である可能性のある動的な XPath で有効です)、接頭辞つきの名前テストを使用し、その接頭辞を名前空間にマッピングする名前空間リゾルバーを作成する必要があります。詳しくは下記のユーザー定義の名前空間リゾルバーを作成する方法を参照して下さい。

+注: XPath では接頭辞のない QName は名前空間が null の要素にのみ一致すると定義しています。 XPath には、通常の要素参照に適用される既定の名前空間を取得する手段はありません。 (例: `xmlns='http://www.w3.org/1999/xhtml'` に対する `p[@id='_myid']`)。名前空間が null ではない既定の要素に一致させるには、 `['namespace-uri()='http://www.w3.org/1999/xhtml' and name()='p' and @id='_myid']` のような形を使用して特定の要素を参照するか ([このアプローチ](#using_xpath_functions_to_reference_elements_with_a_default_namespace)は名前空間が不明である可能性のある動的な XPath で有効です)、接頭辞つきの名前テストを使用し、その接頭辞を名前空間にマッピングする名前空間リゾルバーを作成する必要があります。詳しくは下記の[ユーザー定義の名前空間リゾルバーを作成する](#ユーザー定義の名前空間リゾルバーの実装)方法を参照して下さい。 -

注

+### 注 -

任意の DOM ノードを名前空間の解決に適応させると、 XPath 式が文書内に現れたノードのコンテキストに関連して簡単に評価できるようになります。このアダプターは、ノード上の DOM Level 3 メソッド lookupNamespaceURI と同様に動作し、 lookupNamespaceURI が呼び出された時点でノードの階層で利用可能な現在の情報を使用して、指定された接頭辞から namespaceURI を解決します。また、暗黙の xml 接頭辞も正しく解決します。

+任意の DOM ノードを名前空間の解決に適応させると、 [XPath](/ja/docs/Web/XPath) 式が文書内に現れたノードのコンテキストに関連して簡単に評価できるようになります。このアダプターは、ノード上の DOM Level 3 メソッド `lookupNamespaceURI` と同様に動作し、 `lookupNamespaceURI` が呼び出された時点でノードの階層で利用可能な現在の情報を使用して、指定された接頭辞から `namespaceURI` を解決します。また、暗黙の `xml` 接頭辞も正しく解決します。 -

返値の型を指定する

+### 返値の型の指定 -

document.evaluate から返される変数 xpathResult は、単一のノード (単純型) もしくはノードのコレクション (ノード集合型) から成ります。

+`document.evaluate` から返される変数 `xpathResult` は、単一のノード ([単純型](#simple_types)) もしくはノードのコレクション ([ノード集合型](#node-set_types)) から成ります。 -

単純型

+#### 単純型 -

resultType で要求された結果型が次のうちのどれかであった場合、

+`resultType` で要求された結果型が次のうちのどれかであった場合、 - +- `NUMBER_TYPE` - 倍精度浮動小数点数 (double) +- `STRING_TYPE` - 文字列 +- `BOOLEAN_TYPE` - 論理値 -

それぞれ以下の XPathResult オブジェクトのプロパティにアクセスすることで式の返値を得る事ができます。

+それぞれ以下の `XPathResult` オブジェクトのプロパティにアクセスすることで式の返値を得る事ができます。 - +- `numberValue` +- `stringValue` +- `booleanValue` -
例
+##### 例 -

下の例では XPath 式 count(//p) によって HTML 文書内の <p> 要素の数を取得しています。

+下の例では XPath 式 `[count(//p)](/ja/docs/Web/XPath/Functions/count)` によって HTML 文書内の `

` 要素の数を取得しています。 -

var paragraphCount = document.evaluate( 'count(//p)', document, null, XPathResult.ANY_TYPE, null );
+```js
+var paragraphCount = document.evaluate( 'count(//p)', document, null, XPathResult.ANY_TYPE, null );
 
 alert( 'この文書には ' + paragraphCount.numberValue + ' 個の段落要素が含まれています' );
-
+``` -

JavaScript では数値を表示しようとすると文字列に変換されますが、 XPath インターフェイスは stringValue プロパティを要求しても数値の結果を自動的に変換しないので、下のコードは動作しません。

+JavaScript では数値を表示しようとすると文字列に変換されますが、 XPath インターフェイスは `stringValue` プロパティを要求しても数値の結果を自動的に変換しないので、下のコードは**動作しません**。 -
var paragraphCount = document.evaluate('count(//p)', document, null, XPathResult.ANY_TYPE, null );
+```js
+var paragraphCount = document.evaluate('count(//p)', document, null, XPathResult.ANY_TYPE, null );
 
 alert( 'この文書には ' + paragraphCount.stringValue + ' 個の段落要素が含まれています' );
-
- -

これを実行すると NS_DOM_TYPE_ERROR コードの例外が返されます。

+``` -

ノード集合型

+これを実行すると `NS_DOM_TYPE_ERROR` コードの例外が返されます。 -

XPathResult オブジェクトが返すノード集合には主として 3 種類の型があります。

+#### ノード集合型 - +`XPathResult` オブジェクトが返すノード集合には主として 3 種類の型があります。 -
イテレーター
+- [イテレーター](#iterators) +- [スナップショット](#snapshots) +- [ファーストノード](#first_node) -

引数 resultType で指定された結果型が次のどちらかの場合、

+##### イテレーター - +引数 `resultType` で指定された結果型が次のどちらかの場合、 -

一致したノードのノード集合が XPathResult オブジェクトとして返されます。これはイテレーターのようにふるまい、 XPathResult の iterateNext() メソッドを使ってその中に含まれる個々のノードにアクセスできます。

+- `UNORDERED_NODE_ITERATOR_TYPE` +- `ORDERED_NODE_ITERATOR_TYPE` -

一致したノードに対する反復が全て終了すると、 iterateNext() は null を返します。

+一致したノードのノード集合が `XPathResult` オブジェクトとして返されます。これはイテレーターのようにふるまい、 `XPathResult` の `iterateNext()` メソッドを使ってその中に含まれる個々のノードにアクセスできます。 -

ただし、反復処理中に文書が変異した (文書ツリーが改変された) 場合、反復処理は無効化され、XPathResult の invalidIteratorState プロパティが true に設定され、NS_ERROR_DOM_INVALID_STATE_ERR 例外が投げられます。

+一致したノードに対する反復が全て終了すると、 `iterateNext()` は `null` を返します。 -
イテレーターの使用例
+ただし、反復処理中に文書が変異した (文書ツリーが改変された) 場合、反復処理は無効化され、`XPathResult` の `invalidIteratorState` プロパティが `true` に設定され、`NS_ERROR_DOM_INVALID_STATE_ERR` 例外が投げられます。 -
var iterator = document.evaluate('//phoneNumber', documentNode, null, XPathResult.UNORDERED_NODE_ITERATOR_TYPE, null );
+```js
+var iterator = document.evaluate('//phoneNumber', documentNode, null, XPathResult.UNORDERED_NODE_ITERATOR_TYPE, null );
 
 try {
   var thisNode = iterator.iterateNext();
@@ -147,77 +140,73 @@ try {
 catch (e) {
   alert( 'Error: Document tree modified during iteration ' + e );
 }
-
+``` -
スナップショット
+##### スナップショット -

引数 resultType で指定された結果型が次のどちらかの場合、

+引数 `resultType` で指定された結果型が次のどちらかの場合、 - +- `UNORDERED_NODE_SNAPSHOT_TYPE` +- `ORDERED_NODE_SNAPSHOT_TYPE` -

返される XPathResult オブジェクトは一致したノードの静的な集合となり、 XPathResult オブジェクトの snapshotItem(itemNumber) メソッドによってそれぞれのノードにアクセスできます。itemNumber は取り出すノードのインデックスです。含まれるノードの総数は snapshotLength プロパティから得られます。

+返される `XPathResult` オブジェクトは一致したノードの静的な集合となり、 `XPathResult` オブジェクトの `snapshotItem(itemNumber)` メソッドによってそれぞれのノードにアクセスできます。`itemNumber` は取り出すノードのインデックスです。含まれるノードの総数は `snapshotLength` プロパティから得られます。 -

スナップショットは文書が変化しても変更されず、イテレーターと違って無効になることはありませんが、スナップショットは現在の文書に対応しないことがあります。ノードが移動されていたり、既に存在しないノードが含まれていたり、新しいノードが追加されている可能性もあります。

+スナップショットは文書が変化しても変更されず、イテレーターと違って無効になることはありませんが、スナップショットは現在の文書に対応しないことがあります。ノードが移動されていたり、既に存在しないノードが含まれていたり、新しいノードが追加されている可能性もあります。 -
スナップショットの使用例
+```js +var nodesSnapshot = document.evaluate('//phoneNumber', documentNode, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null ); -
var nodesSnapshot = document.evaluate('//phoneNumber', documentNode, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null );
-
-for ( var i=0 ; i < nodesSnapshot.snapshotLength; i++ )
+for ( var i=0 ; i < nodesSnapshot.snapshotLength; i++ )
 {
   alert( nodesSnapshot.snapshotItem(i).textContent );
 }
-
- -
ファーストノード
+``` -

引数 resultType で指定された結果型が次のどちらかの場合、

+##### ファーストノード - +引数 `resultType` で指定された結果型が次のどちらかの場合、 -

返される XPathResult オブジェクトは XPath 式に一致するノードのうち最初に見つかったもののみです。このノードには XPathResult オブジェクトの singleNodeValue プロパティによってアクセスできます。ノード集合が空ならばこのプロパティは null になります。

+- `ANY_UNORDERED_NODE_TYPE` +- `FIRST_ORDERED_NODE_TYPE` -

ただし、 unordered サブタイプの場合、返される単一のノードは文書順において最初のものではない可能性があるので注意が必要です。 ordered サブタイプの場合は文書順において最初に一致するノードであることが保証されます。

+返される `XPathResult` オブジェクトは XPath 式に一致するノードのうち最初に見つかったもののみです。このノードには `XPathResult` オブジェクトの `singleNodeValue` プロパティによってアクセスできます。ノード集合が空ならばこのプロパティは `null` になります。 -
ファーストノードの使用例
+ただし、 unordered サブタイプの場合、返される単一のノードは文書順において最初のものではない可能性があるので注意が必要です。 ordered サブタイプの場合は文書順において最初に一致するノードであることが保証されます。 -
var firstPhoneNumber = document.evaluate('//phoneNumber', documentNode, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null );
+```js
+var firstPhoneNumber = document.evaluate('//phoneNumber', documentNode, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null );
 
 alert( 'The first phone number found is ' + firstPhoneNumber.singleNodeValue.textContent );
-
+``` -

ANY_TYPE 定数

+#### ANY_TYPE 定数 -

引数 resultType に指定された結果型が ANY_TYPE である場合、返される XPathResult オブジェクトは、式を評価した結果から導き出される適切な型になります。

+引数 `resultType` に指定された結果型が `ANY_TYPE` である場合、返される `XPathResult` オブジェクトは、式を評価した結果から導き出される適切な型になります。 -

返される結果型は単純型 (NUMBER_TYPE, STRING_TYPE, BOOLEAN_TYPE ) のうちのいずれにもなり得ますが、もしノード集合であった場合には、UNORDERED_NODE_ITERATOR_TYPE にしかなり得ません。

+返される結果型は単純型 (`NUMBER_TYPE, STRING_TYPE, BOOLEAN_TYPE` ) のうちのいずれにもなり得ます**が**、もしノード集合であった場合には、`UNORDERED_NODE_ITERATOR_TYPE` に**しか**なり得ません。 -

評価の後に型を判断するには、 XPathResult オブジェクトの resultType プロパティを使います。このプロパティの定数値は付録に記載されています。 None Yet =====Any_Type Example===== <pre> </pre>

+評価の後に型を判断するには、 `XPathResult` オブジェクトの `resultType` プロパティを使います。このプロパティの[定数](#xpathresult_の定義済み定数)値は付録に記載されています。 None Yet =====Any_Type Example===== \
 \
-

例

+## 例 -

HTML 文書内で

+### HTML 文書内で -

下のコードは、 XPath 式を評価する対象となる HTML 文書の内部や、それにリンクされた JavaScript 内に設置するためのものです。

+下のコードは、 XPath 式を評価する対象となる HTML 文書の内部や、それにリンクされた JavaScript 内に設置するためのものです。 -

XPath を使って HTML 文書内のすべての <h2> 見出し要素を抽出したければ、xpathExpression は単に '//h2' となります。 // は再帰下降演算子 (Recursive Descent Operator) なので、この式は文書ツリー内のあらゆる位置にある、nodeName が h2 である要素に一致します。 link to introductory xpath doc

+XPath を使って HTML 文書内のすべての `

` 見出し要素を抽出したければ、`xpathExpression` は単に '`//h2`' となります。 `//` は再帰下降演算子 (Recursive Descent Operator) なので、この式は文書ツリー内のあらゆる位置にある、nodeName が `h2` である要素に一致します。 -
var headings = document.evaluate('//h2', document, null, XPathResult.ANY_TYPE, null );
-
+```js +var headings = document.evaluate('//h2', document, null, XPathResult.ANY_TYPE, null ); +``` -

HTML には名前空間がないため、引数 namespaceResolver には null を渡している事に注目してください。

+HTML には名前空間がないため、引数 `namespaceResolver` には `null` を渡している事に注目してください。 -

文書全体から見出し要素を探すため、ここでは document オブジェクト自体を contextNode として使っています。

+文書全体から見出し要素を探すため、ここでは [document](/ja/docs/Web/API/Document) オブジェクト自体を `contextNode` として使っています。 -

この式の結果は XPathResult オブジェクトです。返された結果の型を知りたい場合は、返されたオブジェクトの resultType プロパティを評価してください。この場合は 4 、つまり UNORDERED_NODE_ITERATOR_TYPE と評価されるでしょう。これは XPath 式の結果がノード集合であった場合の既定の結果型です。この型はノードに一つずつアクセスすることができ、返されるノードの順序は決まっていません。返されたノードにアクセスするには、返されたオブジェクトの iterateNext() メソッドを使います。

+この式の結果は `XPathResult` オブジェクトです。返された結果の型を知りたい場合は、返されたオブジェクトの `resultType` プロパティを評価してください。この場合は `4` 、つまり `UNORDERED_NODE_ITERATOR_TYPE` と評価されるでしょう。これは XPath 式の結果がノード集合であった場合の既定の結果型です。この型はノードに一つずつアクセスすることができ、返されるノードの順序は決まっていません。返されたノードにアクセスするには、返されたオブジェクトの `iterateNext()` メソッドを使います。 -
var thisHeading = headings.iterateNext();
+```js
+var thisHeading = headings.iterateNext();
 
 var alertText = 'この文書内のレベル 2 の見出しは、\n'
 
@@ -225,34 +214,36 @@ while (thisHeading) {
   alertText += thisHeading.textContent + '\n';
   thisHeading = headings.iterateNext();
 }
-
+``` -

反復によってノードを得られたら、そのノードのすべての標準 DOM インターフェイスにアクセスできます。式によって返される h2 要素に対する反復処理が全て終了すると、それ以降は iterateNext() を何度呼び出しても null が返されます。

+反復によってノードを得られたら、そのノードのすべての標準 DOM インターフェイスにアクセスできます。式によって返される `h2` 要素に対する反復処理が全て終了すると、それ以降は `iterateNext()` を何度呼び出しても `null` が返されます。 -

拡張機能内の XML 文書に対して評価する

+### 拡張機能内の XML 文書に対して評価する -

例として XML 文書が chrome://yourextension/content/peopleDB.xml にあったとします。

+例として XML 文書が `chrome://yourextension/content/peopleDB.xml` にあったとします。 -
<?xml version="1.0"?>
-<people xmlns:xul = "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" >
-  <person>
-	<name first="george" last="bush" />
-	<address street="1600 pennsylvania avenue" city="washington" country="usa"/>
-	<phoneNumber>202-456-1111</phoneNumber>
-  </person>
-  <person>
-	<name first="tony" last="blair" />
-	<address street="10 downing street" city="london" country="uk"/>
-	<phoneNumber>020 7925 0918</phoneNumber>
-  </person>
-</people>
-
+```xml + + + + +
+ 202-456-1111 + + + +
+ 020 7925 0918 + + +``` -

拡張機能内で XML 文書の内容を取得できるようにするため、XMLHttpRequest オブジェクトを作成して文書を同期的に読み込みます。変数 xmlDoc には文書が XMLDocument オブジェクトとして格納されるので、それに対して evaluate メソッドを使う事ができます。

+拡張機能内で XML 文書の内容を取得できるようにするため、`[XMLHttpRequest](/ja/XMLHttpRequest)` オブジェクトを作成して文書を同期的に読み込みます。変数 `xmlDoc` には文書が `[XMLDocument](/ja/XMLDocument)` オブジェクトとして格納されるので、それに対して `evaluate` メソッドを使う事ができます。 -

拡張機能の xul/js 文書で使用する JavaScript は以下の通りです。

+拡張機能の xul/js 文書で使用する JavaScript は以下の通りです。 -
var req = new XMLHttpRequest();
+```js
+var req = new XMLHttpRequest();
 
 req.open("GET", "chrome://yourextension/content/peopleDB.xml", false);
 req.send(null);
@@ -262,168 +253,117 @@ var xmlDoc = req.responseXML;
 var nsResolver = xmlDoc.createNSResolver( xmlDoc.ownerDocument == null ? xmlDoc.documentElement : xmlDoc.ownerDocument.documentElement);
 
 var personIterator = xmlDoc.evaluate('//person', xmlDoc, nsResolver, XPathResult.ANY_TYPE, null );
-
+``` -

注

+### 注 -

XPathResult オブジェクトが定義されていない場合は、 Components.interfaces.nsIDOMXPathResult.ANY_TYPE (CI.nsIDOMXPathResult) を使用して、特権的なコードで定数を取得できます。同様に、 XPathEvaluator は次のようにして作成できます。

+XPathResult オブジェクトが定義されていない場合は、 `Components.interfaces.nsIDOMXPathResult.ANY_TYPE` (`CI.nsIDOMXPathResult`) を使用して、特権的なコードで定数を取得できます。同様に、 XPathEvaluator は次のようにして作成できます。 -
Components.classes["@mozilla.org/dom/xpath-evaluator;1"].createInstance(Components.interfaces.nsIDOMXPathEvaluator)
+```js +Components.classes["@mozilla.org/dom/xpath-evaluator;1"].createInstance(Components.interfaces.nsIDOMXPathEvaluator) +``` -

付録

+## 付録 -

ユーザー定義の名前空間リゾルバーの実装

+### ユーザー定義の名前空間リゾルバーの実装 -

この例は説明のためだけのものです。 この関数は、xpathExpression から名前空間接頭辞を取り、その接頭辞に対応する URI を返さなければなりません。例えば、この式は、

+この例は説明のためだけのものです。 この関数は、`xpathExpression` から名前空間接頭辞を取り、その接頭辞に対応する URI を返さなければなりません。例えば、この式は、 -
'//xhtml:td/mathml:math'
-
+ '//xhtml:td/mathml:math' -

(X)HTML のテーブルデータセル要素の子要素である全ての MathML 式を選択します。

+(X)HTML のテーブルデータセル要素の子要素である全ての [MathML](/ja/docs/Web/MathML) 式を選択します。 -

接頭辞 'mathml:' と 名前空間 URI 'http://www.w3.org/1998/Math/MathML' を、接頭辞 'xhtml:' と URI 'http://www.w3.org/1999/xhtml' をそれぞれ関連付けるため、関数を用意します。

+接頭辞 '`mathml:`' と 名前空間 URI '`http://www.w3.org/1998/Math/MathML`' を、接頭辞 '`xhtml:`' と URI '`http://www.w3.org/1999/xhtml`' をそれぞれ関連付けるため、関数を用意します。 -
function nsResolver(prefix) {
+```js
+function nsResolver(prefix) {
   var ns = {
     'xhtml' : 'http://www.w3.org/1999/xhtml',
     'mathml': 'http://www.w3.org/1998/Math/MathML'
   };
   return ns[prefix] || null;
 }
-
+``` -

そうすると document.evaluate をこのようにして呼び出せます。

+そうすると `document.evaluate` をこのようにして呼び出せます。 -
document.evaluate( '//xhtml:td/mathml:math', document, nsResolver, XPathResult.ANY_TYPE, null );
-
+```js +document.evaluate( '//xhtml:td/mathml:math', document, nsResolver, XPathResult.ANY_TYPE, null ); +``` -

XML 文書の既定の名前空間を実装する

+### XML 文書の既定の名前空間を実装する -

既定の名前空間リゾルバーの実装で述べたように、既定のリゾルバーは XML 文書の既定の名前空間を処理しません。たとえばこの文書では、

+[既定の名前空間リゾルバーの実装](#既定の名前空間リゾルバーの実装)で述べたように、既定のリゾルバーは XML 文書の既定の名前空間を処理しません。たとえばこの文書では、 -
<?xml version="1.0" encoding="UTF-8"?>
-<feed xmlns="http://www.w3.org/2005/Atom">
-    <entry />
-    <entry />
-    <entry />
-</feed>
-
+```xml + + + + + + +``` -

doc.evaluate('//entry', doc, nsResolver, XPathResult.ANY_TYPE, null) は、nsResolver が createNSResolver によって返されたリゾルバーである場合、空集合を返します。リゾルバーとして null を渡しても同じです。

+`doc.evaluate('//entry', doc, nsResolver, XPathResult.ANY_TYPE, null)` は、`nsResolver` が `createNSResolver` によって返されたリゾルバーである場合、空集合を返します。リゾルバーとして `null` を渡しても同じです。 -

正しい既定の名前空間 (この場合は Atom 名前空間) を返すカスタムリゾルバーを作成すれば、この問題を解決できます。この時、 XPath 式の中ではなんらかの名前空間接頭辞を使わなければならないことに注意してください。これはリゾルバー関数がその接頭辞を指定した名前空間に変換できるようにするためです。例えばこのようにします。

+正しい既定の名前空間 (この場合は Atom 名前空間) を返すカスタムリゾルバーを作成すれば、この問題を解決できます。この時、 XPath 式の中ではなんらかの名前空間接頭辞を使わなければならないことに注意してください。これはリゾルバー関数がその接頭辞を指定した名前空間に変換できるようにするためです。例えばこのようにします。 -
function resolver() {
+```js
+function resolver() {
     return 'http://www.w3.org/2005/Atom';
 }
 doc.evaluate('//myns:entry', doc, resolver, XPathResult.ANY_TYPE, null)
-
+``` -

なお、文書で複数の名前空間が使われている場合には、より複雑なリゾルバーが必要になります。

+なお、文書で複数の名前空間が使われている場合には、より複雑なリゾルバーが必要になります。 -

次の節では、より効果的に機能する (名前空間を事前に知らなくてもよい) アプローチについて説明します。

+次の節では、より効果的に機能する (名前空間を事前に知らなくてもよい) アプローチについて説明します。 -

XPath 関数を使用して既定の名前空間の要素を参照する

+### XPath 関数を使用して既定の名前空間の要素を参照する -

null ではない名前空間の既定の要素に一致させる (そして名前空間が分からない動的な XPath 式で上手く動作する) もう一つの方法として、 [namespace-uri()='http://www.w3.org/1999/xhtml' and name()='p' and @id='_myid'] のような形式で特定の要素を参照する方法があります。これにより、XPath クエリーが正規にラベル付けされた要素の既定の名前空間を検出できないという問題が回避されます。

+null ではない名前空間の既定の要素に一致させる (そして名前空間が分からない動的な XPath 式で上手く動作する) もう一つの方法として、 `[namespace-uri()='http://www.w3.org/1999/xhtml' and name()='p' and @id='_myid']` のような形式で特定の要素を参照する方法があります。これにより、XPath クエリーが正規にラベル付けされた要素の既定の名前空間を検出できないという問題が回避されます。 -

接頭辞に関係ない、名前空間付きの要素や属性の取得

+### 接頭辞に関係ない、名前空間付きの要素や属性の取得 -

名前空間の要素や属性を見つける際に特定の接頭辞を必ずしも必要とせず、 (意図的に) 名前空間に柔軟性を持たせたい場合は、特別な手法を用いなければなりません。

+名前空間の要素や属性を見つける際に特定の接頭辞を必ずしも必要とせず、 (意図的に) 名前空間に柔軟性を持たせたい場合は、特別な手法を用いなければなりません。 -

上の節のアプローチを応用して、選択された接頭辞に関係なく名前空間の要素をテストすることは (local-name() と namespace-uri() を組み合わせて name() の代わりに使用すれば) 可能ですが、特定の名前空間属性を持つ要素を述語の中に取り込みたい場合には、より困難な状況が発生します (XPath 1.0 には実装に依存しない変数が存在しないため)。

+上の節のアプローチを応用して、選択された接頭辞に関係なく名前空間の要素をテストすることは ([`local-name()`](/ja/docs/Web/XPath/Functions/local-name) と [`namespace-uri()`](/ja/docs/Web/XPath/Functions/namespace-uri) を組み合わせて [`name()`](/ja/docs/Web/XPath/Functions/name) の代わりに使用すれば) 可能ですが、特定の名前空間属性を持つ要素を述語の中に取り込みたい場合には、より困難な状況が発生します (XPath 1.0 には実装に依存しない変数が存在しないため)。 -

たとえば、次のように namespaced 属性を持つ要素を取得しようとすると、 (間違って) var xpathlink = someElements[local-name(@*)="href" and namespace-uri(@*)='http://www.w3.org/1999/xlink']; となります。

+たとえば、次のように namespaced 属性を持つ要素を取得しようとすると、 (間違って) `var xpathlink = someElements[local-name(@*)="href" and namespace-uri(@*)='http://www.w3.org/1999/xlink'];` となります。 -

この方法では、ローカル名が "href" である属性が存在しても、その属性が (@href ではなく) 対象となる (XLink) 名前空間を持つ別の属性であった場合、誤って一部の要素を取得してしまう可能性があります。

+この方法では、ローカル名が "`href`" である属性が存在しても、その属性が (`[@href](/ja/docs/Web/XPath/Axes/attribute)` ではなく) 対象となる (XLink) 名前空間を持つ別の属性であった場合、誤って一部の要素を取得してしまう可能性があります。 -

XLink の @href 属性を持つ要素を (名前空間リゾルバーで定義済みの接頭辞にとらわれずに) 正確に把握するためには、次のようにして取得することができます。

+XLink の `@href` 属性を持つ要素を (名前空間リゾルバーで定義済みの接頭辞にとらわれずに) 正確に把握するためには、次のようにして取得することができます。 -
var xpathEls = 'someElements[@*[local-name() = "href" and namespace-uri() = "http://www.w3.org/1999/xlink"]]'; // Grabs elements with any single attribute that has both the local name 'href' and the XLink namespace
+```js
+var xpathEls = 'someElements[@*[local-name() = "href" and namespace-uri() = "http://www.w3.org/1999/xlink"]]'; // Grabs elements with any single attribute that has both the local name 'href' and the XLink namespace
 var thislevel = xml.evaluate(xpathEls, xml, null, XPathResult.ANY_TYPE, null);
 var thisitemEl = thislevel.iterateNext();
-
- -

XPathResult の定義済み定数

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
定義済みの結果型定数値解説
ANY_TYPE0式の評価によって導き出される適切な型を格納した結果の集合。結果がノード集合ならば、結果の型は常に UNORDERED_NODE_ITERATOR_TYPE となるので注意が必要。
NUMBER_TYPE1一つの数値を格納した結果。 count() 関数を使用した XPath 式などで有用。
STRING_TYPE2一つの文字列を格納した結果。
BOOLEAN_TYPE3一つの真偽値を格納した結果。 not() 関数を使用した XPath 式などで有用。
UNORDERED_NODE_ITERATOR_TYPE4一致した全てのノードを格納した結果ノード集合。ノードの順番は文書内に現れる順番と必ずしも一致しない。
ORDERED_NODE_ITERATOR_TYPE5一致した全てのノードを格納した結果ノード集合。ノードの順番は文書内に現れる順番に一致する。
UNORDERED_NODE_SNAPSHOT_TYPE6一致した全てのノードのスナップショットを格納した結果ノード集合。ノードの順番は文書内に現れる順番と必ずしも一致しない。
ORDERED_NODE_SNAPSHOT_TYPE7一致した全てのノードのスナップショットを格納した結果ノード集合。ノードの順番は文書内に現れる順番に一致する。
ANY_UNORDERED_NODE_TYPE8一致したノードのうちのどれか一つを格納した結果ノード集合。これは必ずしも文書内で式に一致した最初のノードというわけではない。
FIRST_ORDERED_NODE_TYPE9一致内で式に一致した最初のノードを格納した結果ノード集合。
- -

関連情報

- - - -
-

原文情報

- -
    -
  • 原文 Mozilla XPath Tutorial に基づいて作成されています。
    • -
  • 原文の著者: James Graham
    • -
  • その他の貢献者: James Thompson
    • -
  • 最終更新日: 2006 年 3 月 25 日
    • -
-
- -

 

+``` + +### XPathResult の定義済み定数 + +| 定義済みの結果型定数 | 値 | 説明 | +| ---------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| ANY_TYPE | 0 | 式の評価によって導き出される適切な型を格納した結果の集合。結果がノード集合ならば、結果の型は常に UNORDERED_NODE_ITERATOR_TYPE となるので注意が必要。 | +| NUMBER_TYPE | 1 | 一つの数値を格納した結果。 `count()` 関数を使用した XPath 式などで有用。 | +| STRING_TYPE | 2 | 一つの文字列を格納した結果。 | +| BOOLEAN_TYPE | 3 | 一つの論理値を格納した結果。 `not()` 関数を使用した XPath 式などで有用。 | +| UNORDERED_NODE_ITERATOR_TYPE | 4 | 一致した全てのノードを格納した結果ノード集合。ノードの順番は文書内に現れる順番と必ずしも一致しない。 | +| ORDERED_NODE_ITERATOR_TYPE | 5 | 一致した全てのノードを格納した結果ノード集合。ノードの順番は文書内に現れる順番に一致する。 | +| UNORDERED_NODE_SNAPSHOT_TYPE | 6 | 一致した全てのノードのスナップショットを格納した結果ノード集合。ノードの順番は文書内に現れる順番と必ずしも一致しない。 | +| ORDERED_NODE_SNAPSHOT_TYPE | 7 | 一致した全てのノードのスナップショットを格納した結果ノード集合。ノードの順番は文書内に現れる順番に一致する。 | +| ANY_UNORDERED_NODE_TYPE | 8 | 一致したノードのうちのどれか一つを格納した結果ノード集合。これは必ずしも文書内で式に一致した最初のノードというわけではない。 | +| FIRST_ORDERED_NODE_TYPE | 9 | 一致内で式に一致した最初のノードを格納した結果ノード集合。 | + +## 関連情報 + +- [XPath](/ja/docs/Web/XPath) +- [XML Path Language](http://www.xml.com/pub/a/2000/08/holman/index.html?page=2#xpath-info) from _[What is XSLT?](http://www.xml.com/pub/a/2000/08/holman/)_ by G. Ken Holman + +## 原著情報 + +- 原文 [Mozilla XPath Tutorial](http://www-xray.ast.cam.ac.uk/~jgraham/mozilla/xpath-tutorial.html) に基づいて作成されています。 +- 原文の著者: James Graham +- その他の貢献者: James Thompson +- 最終更新日: 2006 年 3 月 25 日 -- cgit v1.2.3-54-g00ecf