[43] [DFN[[[DOM XPath]]]] は、 [[XPath 1.0]] を使って[[DOM木]]上の[[節点]]を取得する [[API]] です。 [44] 現行のすべての主要 [[Webブラウザー]]に実装されています。かつてはよく用いられていましたが、 異様に複雑な [[API]] のため、 [[Selectors API]] が実装されてからはほとんど使うこともなくなりました。 * 代替 [46] [[Selectors API]] と通常の [[DOM API]] でほとんど代用できます。 * 仕様書 [REFS[ - [41] [CITE@en[DOM XPath - WHATWG Wiki]] ([TIME[2014-10-23 08:39:56 +09:00]] 版) ]REFS] [42] [[DOM3 XPath]] が10年以上メンテナンスされておらず、事実上標準不在状態となっています。 * 歴史 ** MSXML XPath - [20] [CODE(DOMm)@en[[[selectNodes]]]] - [21] [CODE(DOMm)@en[[[selectSingleNode]]]] [15] [CITE[IRC logs: freenode / #whatwg / 20101008]] ( ([TIME[2010-10-22 22:12:03 +09:00]] 版)) ** DOM3 XPath - [24] [CODE(DOMi)@en[[[XPathNSResolver]]]] [1] [CITE[Introduction to using XPath in JavaScript - MDC]] ([[名無しさん]]) [2] [CITE[Latest topics > getElementsByなんちゃら の代わりにXPathを使う - outsider reflex]] ([[Piro(SHIMODA Hiroshi)]] 著, [CODE[2007-09-09 11:44:24 +09:00]] 版) ([[名無しさん]]) [3] [CITE@en[SourceForge.net: XPath over HTML for MSIE]] ([CODE[2007-10-06 15:19:21 +09:00]] 版) ([[名無しさん]]) [4] [CITE@ja[Safari 3 の XPath のバグ: Days on the Moon]] ([CODE[2008-05-11 15:36:16 +09:00]] 版) ([[名無しさん]]) [5] [CITE@ja[選択範囲のリンクを取得する: Days on the Moon]] ([CODE[2008-10-19 11:34:21 +09:00]] 版) ([[名無しさん]]) [6] [CITE[XPath は実用に耐えうるかの考察と xpath.js - IT戦記]] ([CODE[2008-10-31 22:50:48 +09:00]] 版) ([[名無しさん]]) [7] [CITE[HTML 用の XPath 機能テストを書いた - IT戦記]] ([TIME[2008-10-31 23:00:27 +09:00]] 版) [8] [CITE[JavaScript-XPath をリリースしました!さあ、あなたも XPath を使おう!(解説付き) - IT戦記]] ([TIME[2009-02-02 02:01:53 +09:00]] 版) [9] [CITE[JavaScript-XPath – CodeRepos::Share – Trac]] ([TIME[2009-02-02 11:11:12 +09:00]] 版) [10] [CITE[はてなブックマークのコンテンツの JavaScript を高速化する - IT戦記]] ([TIME[2009-02-08 18:51:12 +09:00]] 版) [11] [CITE@ja[XPath, $X function, NSResolver < 16 < March < 2006 < nulog, NULL::something : out of the headphone]] ([TIME[2009-02-01 19:18:32 +09:00]] 版) [12] [CITE@ja[Kanasan.JS Greasemonkey チュートリアル読書会: Days on the Moon]] ([TIME[2009-03-23 00:03:31 +09:00]] 版) >document.evaluate メソッドの返り値である XPathResult オブジェクトを、別の evaluate メソッドの呼び出し時に第5引数として渡すと、その XPathResult オブジェクトが再利用されます。しかし、「再利用される」とは具体的にどうなることかという説明は DOM 3 XPath 仕様中になく、そもそも "'''may''' be reused" (強調は筆者による) なので確実に再利用されるという保証もありません。Firefox (Gecko) と Opera では第 5 引数に渡したオブジェクトが返り値となりますが、Safari (WebKit) では常に新しいオブジェクトを生成して返すようです。ちなみに Firefox では第 5 引数を指定すると意図しない結果になることがあります。 > [PRE(JS example code)[ var result = document.evaluate("'foo'", document, null, XPathResult.STRING_TYPE, null); document.evaluate("'bar'", document, null, XPathResult.STRING_TYPE, result); result.stringValue; // Firefox 3.6a1pre => "foobar" ("bar" を期待していたのに!) // Opera 9.64 => "bar" // Safari 3.1.2 => "foo" ]PRE] > XPathResult には結果の型として順序付きのもの (ORDERED_NODE_ITERATOR_TYPE、ORDERED_NODE_SNAPSHOT_TYPE、FIRST_ORDERED_NODE_TYPE) と順序なしのもの (UNORDERED_NODE_ITERATOR_TYPE、UNORDERED_NODE_SNAPSHOT_TYPE、ANY_UNORDERED_NODE_TYPE) があります。ソースコードを見る限り、WebKit では順序付きかどうかで処理を分けていますが、Gecko では順序なしでも順序付きと同等に扱っているようです。 [16] [CITE@en[DOM XPath - WHATWG Wiki]] ( ([TIME[2012-04-10 18:16:04 +09:00]] 版)) [17] [CITE@en-US[Document Object Model (DOM) Level 3 XPath Specification]] ( ([TIME[2004-02-23 21:49:04 +09:00]] 版)) [18] [CITE@en-US[Document Object Model (DOM) Level 3 XPath Specification]] ( ([TIME[2004-02-23 21:49:04 +09:00]] 版)) [19] [CITE@en-US[Document Object Model (DOM) Requirements]] ( ([TIME[2004-02-23 21:14:24 +09:00]] 版)) [23] [[Firefox]] は [CODE(JS)@en[[[document.evaluate]]]] の引数を省略できません。 [[Chrome]] では最初の2つ以外は省略できます。 [TIME[2013-09-25T13:45:03.600Z]] [35] [[Firefox]] は最後の引数が[[オブジェクト]]でなく[[プリミティブ値]]だと例外を投げます。 [[Chrome]] では例外になりません。 [TIME[2013-10-07T14:40:41.500Z]] [30] [CITE[Introduction to DOM XPath - DOM ECMAScripting]] ( ([TIME[2012-02-18 20:10:31 +09:00]] 版)) [31] [[Firefox]] でも [[Chrome]] でも[[文脈節点]]を [CODE(DOMi)@en[[[DocumentFragment]]]] にすると [CODE(DOM)@en[[[NotSupportedError]]]] [[例外]]を投げます。 [TIME[2013-09-30T00:06:57.400Z]] [36] [[Chrome]] では構文解析時でない評価時のエラーは [CODE[[[SyntaxError]]]] にします。 [[Firefox]] は [[DOMException]] ではなさそうな謎のエラーにします。 [TIME[2013-10-07T14:51:21.800Z]] ** XPath と HTML [13] [CITE@en[(X)HTML5 Tracking]] ([TIME[2009-09-29 08:53:48 +09:00]] 版) [14] [CITE[Bug 7059 – Forking XPath]] ([TIME[2009-09-29 08:57:42 +09:00]] 版) [22] [[Firefox]] も [[Chrome]] も、[[既定名前空間]]については [CODE(DOMi)@en[[[NSResolver]]]] を呼び出しません (仕様通りの動作)。 [[HTML文書]]では[[既定名前空間]]の[[名前テスト]]は[[HTML名前空間]]の[[要素]]と[[一致]]します。 [[Firefox]] では更に [[null名前空間]]の[[要素]]とも[[一致]]します。 [[XML文書]]では [[Firefox]] も [[Chrome]] も[[null名前空間]]の[[要素]]とだけ[[一致]]します。どちらの場合もその他の[[名前空間]]とは[[一致]]しません。 [TIME[2013-09-25T13:37:24.800Z]] ** 構文解析 [26] [CODE(DOMi)@en[[[XPathNSResolver]]]] の項も参照。 [25] [[Firefox]] は[[関数名]]の[[名前空間接頭辞]]を[[解決]]した上で、未対応の[[関数]]があれば構文解析エラーとします。 [[Chrome]] は[[関数]]の[[名前空間接頭辞]]を[[解決]]せず、未対応の[[関数]]があれば構文解析エラーとします。 [TIME[2013-09-28T12:41:21.100Z]] [28] [[Firefox]] は[[関数]]の[[引数]]の個数チェックを[[評価]]時に行っているようですが、 [[Chrome]] は[[構文解析]]時に行っているようです。 [TIME[2013-09-28T13:10:47.700Z]] [29] [[Firefox]] も [[Chrome]] も[[引数]]の型チェックは[[構文解析]]時ではなく[[評価]]時に行っているようです。 例えば [CODE[count(12)]] は構文解析エラーになりませんが評価時に例外が投げられます。 [CODE[[[|]]]] [[演算子]]も同様です。 [TIME[2013-09-29T02:02:23.100Z]] [27] [[Firefox]] は[[変数]]が入った[[式]]を構文解析できますが、評価時に [CODE[[[NS_ERROR_ILLEGAL_VALUE]]]] [[例外]]が発生します。なので [CODE(DOMm)@en[[[createExpression]]]] は成功しますが [CODE(JS)@en[[[document.evaluate]]]] は[[例外]]を投げます。 [[Chrome]] は[[変数]]に[[名前空間接頭辞]]があると [CODE(DOM)@en[[[SyntaxError]]]] になります。[[名前空間接頭辞]]がなければ[[評価]]も成功します ([[空文字列]]になるようです)。 [TIME[2013-09-28T12:46:45.400Z]] [32] [CITE@en-US[Document Object Model (DOM) Requirements]] ( ([TIME[2004-02-23 21:14:24 +09:00]] 版)) [33] [CITE@en-US[Introduction to using XPath in JavaScript | MDN]] ( ([TIME[2013-10-01 05:45:01 +09:00]] 版)) [34] [CITE@en-AU[XPath 1.0 in JavaScript • Cameron McCormack's blog]] ( ([TIME[2013-10-05 02:43:05 +09:00]] 版)) [37] [CITE@en[DOM Level 3 XPath Test Suite]] ( ([TIME[2003-02-19 20:32:43 +09:00]] 版)) [38] [[Firefox]] は [CODE(DOMm)@en[[[evaluate]]]] [[メソッド]]の[[文脈オブジェクト]]たる [CODE(DOMi)@en[[[Document]]]] と[[文脈節点]]として指定した[[節点]]の[[文書]]が異なると [CODE(DOMe)@en[[[WRONG_DOCUMENT_ERR]]]] を投げるようです ([[DOM3 XPath]] 仕様に従った動作)。 [[Chrome]] は例外を投げずに処理を続けます。 [TIME[2013-10-12T07:10:36.900Z]] [39] [CITE@en[376740 – XPath expressions in HTML must be lowercase]] ( ([TIME[2013-11-01 00:03:10 +09:00]] 版)) [40] >>39 [[Chrome]] は [[HTML]] の[[要素]]の大文字と小文字を区別しないようですが [[Firefox]] は区別します。 [TIME[2013-11-01T00:05:59.100Z]] [FIG(quote)[ [FIGCAPTION[ [45] [CITE[IRC logs: freenode / #whatwg / 20150903]] ([TIME[2015-09-04 17:43:24 +09:00]] 版) ]FIGCAPTION] > > # '''['''04:43''']''' https://www.chromestatus.com/metrics/feature/timeline/popularity/297 https://www.chromestatus.com/metrics/feature/timeline/popularity/295 https://www.chromestatus.com/metrics/feature/timeline/popularity/296 usage stats... could in theory remove createExpression? > # '''['''04:44''']''' Which would be nice because then we could kill XPathExpression entirely ]FIG] [47] [CITE@en[find: Correct implementation of "xpath" strategy]] ([[jugglinmike]]著, [TIME[2017-06-06 04:07:53 +09:00]]) [48] [CITE@en[domxpath/interfaces.html has no spec to back it up · Issue #7562 · w3c/web-platform-tests]] ([TIME[2017-12-23 15:45:51 +09:00]]) [49] [CITE@en[Make the XPath IDL tests tentative by foolip · Pull Request #7639 · w3c/web-platform-tests]] ([TIME[2017-12-23 15:46:07 +09:00]]) [50] [CITE@en[Add the DOM XPath interfaces from the WHATWG wiki]] ([[annevk]]著, [TIME[2019-08-30 17:38:53 +09:00]]) [51] [CITE@en[Copy the DOM XPath interfaces from the WHATWG wiki by foolip · Pull Request #763 · whatwg/dom]] ([TIME[2020-07-14 15:20:13 +09:00]]) [52] [CITE@en[Consider specifying document.evaluate and document.createNSResolver · Issue #67 · whatwg/dom]] ([TIME[2020-07-14 15:21:50 +09:00]])