XPathResult: singleNodeValue-Eigenschaft

Die schreibgeschützte singleNodeValue-Eigenschaft der XPathResult-Schnittstelle gibt einen Node-Wert zurück oder null, falls kein Knoten eines Ergebnisses mit XPathResult.resultType ANY_UNORDERED_NODE_TYPE oder FIRST_ORDERED_NODE_TYPE übereinstimmt.

Wert

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

Ausnahmen

TYPE_ERR

Falls XPathResult.resultType nicht ANY_UNORDERED_NODE_TYPE oder FIRST_ORDERED_NODE_TYPE ist, wird eine DOMException vom Typ TYPE_ERR ausgelöst.

Beispiele

Das folgende Beispiel zeigt die Verwendung der singleNodeValue-Eigenschaft.

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

Browser-Kompatibilität