Node : méthode contains()
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode contains() de l'interface Node retourne une valeur booléenne indiquant si un nœud est un descendant d'un nœud donné, c'est-à-dire le nœud lui-même, l'un de ses enfants directs (childNodes), l'un des enfants directs de ces enfants, et ainsi de suite.
Note : Un nœud est contenu à l'intérieur de lui-même.
Syntaxe
contains(otherNode)
Paramètres
Valeur de retour
Une valeur booléenne qui est true si otherNode est contenu dans le nœud, false sinon.
Si le paramètre otherNode est null, contains() retourne toujours false.
Exemples
Cette fonction vérifie si un élément est dans le corps de la page. Comme contains est inclusif et que déterminer si le corps se contient lui-même n'est pas l'objectif de isInPage, ce cas retourne explicitement false.
function estDansLaPage(noeud) {
return noeud === document.body ? false : document.body.contains(noeud);
}
Spécifications
| Spécification |
|---|
| DOM # ref-for-dom-node-contains① |
Compatibilité des navigateurs
Voir aussi
- La propriété
Node.compareDocumentPosition - La propriété
Node.hasChildNodes