Node: contains() method
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
js
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
.
js
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