Node: contains() method
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.
The contains()
method of the Node
interface
returns a boolean value indicating
whether a node is a descendant of a given node, that is the node itself,
one of its direct children (childNodes
),
one of the children's direct children, and so on.
Note: A node is contained inside itself.
Syntax
contains(otherNode)
Parameters
Return value
A boolean value that is true
if otherNode
is contained in the node,
false
if not.
If the otherNode
parameter is null
,
contains()
always returns false
.
Example
This function checks to see if an element is in the page's body. As
contains
is inclusive and determining if the body contains itself isn't the
intention of isInPage
this case explicitly returns false
.
function isInPage(node) {
return node === document.body ? false : document.body.contains(node);
}
Specifications
Specification |
---|
DOM Standard # ref-for-dom-node-contains① |
Browser compatibility
BCD tables only load in the browser