XPathResult: singleNodeValue-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.

Die schreibgeschützte singleNodeValue-Eigenschaft des XPathResult-Interfaces gibt einen Node-Wert oder null zurück, falls bei einem Ergebnis mit XPathResult.resultType ANY_UNORDERED_NODE_TYPE oder FIRST_ORDERED_NODE_TYPE kein Knoten übereinstimmte.

Wert

Der Rückgabewert ist der Node-Wert des XPathResult, der durch Document.evaluate() zurückgegeben wird.

Ausnahmen

TYPE_ERR

Falls XPathResult.resultType weder ANY_UNORDERED_NODE_TYPE noch FIRST_ORDERED_NODE_TYPE ist, wird eine XPathException des Typs TYPE_ERR ausgelöst.

Beispiele

Das folgende Beispiel zeigt die Verwendung der singleNodeValue-Eigenschaft.

HTML

html

<div>XPath example</div>
<div>
  Tag name of the element having the text content 'XPath example':
  <output></output>
</div>

JavaScript

const xpath = "//*[text()='XPath example']";
const result = document.evaluate(
  xpath,
  document,
  null,
  XPathResult.FIRST_ORDERED_NODE_TYPE,
  null,
);
document.querySelector("output").textContent = result.singleNodeValue.localName;

Ergebnis

Spezifikationen

Specification
DOM Standard # dom-xpathresult-singlenodevalue

Browser-Kompatibilität

BCD tables only load in the browser