大网数据广告活动
Web 标准与前端开发

Node.contains()

· 52CE 我爱测

Node 接口的 **`contains()`** 方法返回一个布尔值,表示一个节点是否是给定节点的后代,即该节点本身、其直接子节点(Node.childNodes)、子节点的直接子节点等。

DOM

Node 接口的 contains() 方法返回一个布尔值,表示一个节点是否是给定节点的后代,即该节点本身、其直接子节点(Node.childNodes)、子节点的直接子节点等。

[!NOTE] 节点包含在自身内部。

语法

contains(otherNode)

参数

  • otherNode
    • : 要测试的节点。

      [!NOTE] otherNode 不是可选的,但是可以设置为 null。

返回值

返回一个布尔值,如果 otherNode 包含在节点中会返回 true,否则返回 false。

如果 otherNode 参数为 null,则 contains() 始终返回 false。

示例

下面的函数用来检查一个元素是否是 body 元素的后代元素。由于 contains 会包含元素自身,而确定 body 是否包含自身不是设计 isInPage 的意图,这种情况明确返回 false。

function isInPage(node) {
  return node === document.body ? false : document.body.contains(node);
}

规范

浏览器兼容性

参见

  • Node.compareDocumentPosition
  • Node.hasChildNodes

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。