XPathResult: invalidIteratorState-Eigenschaft

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.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die schreibgeschützte invalidIteratorState-Eigenschaft der XPathResult-Schnittstelle zeigt an, dass der Iterator ungültig geworden ist. Sie ist true, wenn XPathResult.resultType UNORDERED_NODE_ITERATOR_TYPE oder ORDERED_NODE_ITERATOR_TYPE ist und das Dokument seit der Rückgabe dieses Ergebnisses geändert wurde.

Wert

Ein boolescher Wert, der angibt, ob der Iterator ungültig geworden ist.

Beispiele

Das folgende Beispiel zeigt die Verwendung der invalidIteratorState-Eigenschaft.

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";

Ergebnis

Spezifikationen

Specification
DOM Standard
# dom-xpathresult-invaliditeratorstate

Browser-Kompatibilität

BCD tables only load in the browser