XPathResult: singleNodeValue 属性

XPathResult 接口的只读 singleNodeValue 属性返回一个 Node 值，或者在没有匹配节点的情况下返回 null，前提是结果的 XPathResult.resultType 为 ANY_UNORDERED_NODE_TYPE 或 FIRST_ORDERED_NODE_TYPE。

值

返回值是由 Document.evaluate() 返回的 XPathResult 的 Node 值。

异常

TYPE_ERR

如果 XPathResult.resultType 不是 ANY_UNORDERED_NODE_TYPE 或 FIRST_ORDERED_NODE_TYPE，则会抛出类型为 TYPE_ERR 的 XPathException。

示例

以下示例展示了 singleNodeValue 属性的使用。

HTML

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

JavaScript

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

结果

规范

规范
DOM 标准
# dom-xpathresult-singlenodevalue

浏览器兼容性

BCD 表格仅在浏览器中加载