XPathResult: snapshotItem() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

snapshotItem() は XPathResult インターフェイスのメソッドで、アイテムのスナップショットの集合、またはインデックスがノードの範囲を外れている場合は null を返します。イテレーターの返値とは異なり、スナップショットは無効になることはありませんが、変更したときに現在の文書に対応しない場合があります。

構文

snapshotItem(i)

引数

i: 数値で、項目のインデックスです。

返値

XPathResult のノード集合内の指定されたインデックスの Node です。

例外

TYPE_ERR

XPathResult.resultType が UNORDERED_NODE_SNAPSHOT_TYPE または ORDERED_NODE_SNAPSHOT_TYPE でない場合、 XPathException による例外が TYPE_ERR 型で発生します。

例

以下の例は snapshotItem() メソッドの使用例を表しています。

HTML

html

<div>XPath example</div>
<div>Tag names of the matched nodes: <output></output></div>

JavaScript

const xpath = "//div";
const result = document.evaluate(
  xpath,
  document,
  null,
  XPathResult.ORDERED_NODE_SNAPSHOT_TYPE,
  null,
);
let node = null;
const tagNames = [];
for (let i = 0; i < result.snapshotLength; i++) {
  node = result.snapshotItem(i);
  tagNames.push(node.localName);
}
document.querySelector("output").textContent = tagNames.join(", ");

結果

仕様書

Specification
DOM # dom-xpathresult-snapshotitem-index-index