XPathEvaluator等とdocument.evaluateの使い分け

Question

JavaScriptでXPathを使いたいとき、document.evaluate()を使うことが多いと思います。

私はむしろつい最近までdocument.evaluate()しか知らなかったのですが、MDNでXPathEvaluatorの存在を知りました。
私の現在の理解では、XPathEvaluatorもdocument.evaluateと同じようにJavaScriptでXPathを評価するのに使えます。

しかも、そのXPathEvaluatorも使い方が1通りではなく、

①XPathEvaluatorオブジェクトのevaluateメソッドを呼ぶ方法

const evaluator = new XPathEvaluator();
const result = evaluator.evaluate("//body", document, null, XPathResult.ANY_UNORDERED_NODE_TYPE);
console.log(result.singleNodeValue);

と、

②XPathExpressionオブジェクトを生成して、そちらのevaluateメソッドを呼ぶ方法

const evaluator = new XPathEvaluator();
const expression = evaluator.createExpression("//body");
const result = expression.evaluate(document, XPathResult.ANY_UNORDERED_NODE_TYPE);
console.log(result.singleNodeValue);

の2通りがあるようです。

そこで疑問なのですが、document.evaluate()とXPathEvaluatorのevaluateとXPathExpressionのevaluateはどのように使い分けるのでしょうか。
それぞれの適する場面が知りたいです。

Answer 1

まず、仕様上、document.evaluate()とXPathEvaluator.evaluate()は全く同じものであるはずです。（Document.createExpression()なども同様）

For historical reasons you can both construct XPathEvaluator and access the same methods on Document.

8.4. Interface XPathEvaluator | DOM Standard

次に、XPathExpression.evaluate()とXPathEvaluator.evaluate()の違いですが、これはXPath（と名前空間）をオブジェクトに持たせることができるので、同じ内容で繰り返し実行するときに、コストを下げることができるだろうと思います。

Comments

[_kari_]

ありがとうございます。
仕様書も読んだつもりだったんですが、該当箇所を見事に見落としておりました…調べ物をするときはちゃんと読まないと駄目ですね。

document.evaluate()とXPathEvaluator.evaluate()は動作は仕様上同じはずということですね。
前者のほうがインスタンス生成の手間が要らないので、基本的にそちらを使っておけばよさそうかなと思いました。
検索してもXPathEvaluator.evaluate()を使っているサンプルがほぼ見つからなかったのですが、動作が一緒ならわざわざこちらを使う必要がないので皆document.evaluate()のほうを使うということ…かな？と。

それで、XPathExpressionオブジェクトを生成しておくとXPath式をコンパイルした形（表現が正しいか自信がありませんが…）にしておけるので、何度も同じXPath式でevaluate()する場合は効率がいい、という感じでしょうか。
でもdocument.evaluate()のほうがよく使われているみたいだから、エンジンの最適化を考えるとむしろdocument.evaluate()のほうがパフォーマンスが良かったりして…さすがにそれはないか（素人考えです）

[_kari_]

想像なのですが、documentにもXPathを扱うメソッドがあるのにXPathEvaluatorが別で用意されている理由は、初期のW3Cの仕様のためかなと思いました。
Javaにも同様のXPathEvaluatorがあるらしく、↓の過去質問を思い出したんです。
https://teratail.com/questions/358309

で、おそらくこれが元になったんじゃないかと思います↓
https://www.w3.org/TR/2001/WD-DOM-Level-3-XPath-20010618/Overview.html
あくまで想像なので、正しいかはわかりませんが…

[Lhankor_Mhy]

仕様書を見る限りだと、わざわざミックスインXPathEvaluatorBase を作っているぐらいなので、おそらく実装も同一のものだと思います。

あとはもう、Chromium のソースコードとか読むしかないのでは。下記を見た感じ、Document にミックスインしていると思います。
https://source.chromium.org/chromium/chromium/src/+/main:third_party/devtools-frontend/src/node_modules/typescript/lib/lib.dom.d.ts;l=4256?q=XPathEvaluatorBase&ss=chromium

[_kari_]

わざわざすみません…ありがとうございます。

こんな質問をしておいてあれですが、パフォーマンスにシビアな使い方をする予定は今のところないので、あまり深い部分は考えないようにしようと思います。