XPathResult: invalidIteratorState プロパティ

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.

invalidIteratorState は XPathResult インターフェイスの読み取り専用プロパティで、イテレーターが不正な状態になったことを示します。 XPathResult.resultType が UNORDERED_NODE_ITERATOR_TYPE または ORDERED_NODE_ITERATOR_TYPE で、この結果を返してから文書が変更された場合は true です。

メモ: この機能はウェブワーカー内で利用可能です。

値

イテレーターが不正になったかどうかを示す論理値。

例

次の例では invalidIteratorState プロパティを使用しています。

HTML

html
<div>XPath example</div>
<p>Iterator state: <output></output></p>

JavaScript

js
const xpath = "//div";
const result = document.evaluate(
  xpath,
  document,
  null,
  XPathResult.ANY_TYPE,
  null,
);
// Invalidates the iterator state
document.querySelector("div").remove();
document.querySelector("output").textContent = result.invalidIteratorState
  ? "invalid"
  : "valid";

結果

仕様書

Specification
DOM Standard
# dom-xpathresult-invaliditeratorstate

ブラウザーの互換性

BCD tables only load in the browser