节点:contains() 方法

contains()Node 接口的方法,它返回一个布尔值,指示节点是否为给定节点的后代,即节点本身、其直接子节点之一(childNodes)、子节点的直接子节点之一,依此类推。

注意:节点包含在自身内部。

语法

js
contains(otherNode)

参数

otherNode

要测试的 Node

注意:otherNode 不是可选的,但可以设置为 null

返回值

如果 otherNode 包含在节点中,则为 true,否则为 false 的布尔值。

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

示例

此函数检查元素是否在页面的主体中。由于 contains 是包含性的,并且确定主体是否包含自身不是 isInPage 的目的,因此此案例明确返回 false

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

规范

规范
DOM 标准
# ref-for-dom-node-contains①

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅