CKTIS / JavaScript
Node.contains — lidmaatschap van de DOM-boom controleren
Node.contains controleert of een opgegeven node de node zelf is of op enige diepte een afstammeling ervan. De methode geeft een booleaanse waarde terug.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
node.contains(other)Node.contains is een instantiemethode van Node en wordt aangeroepen als node.contains(other). De methode geeft true terug als other gelijk is aan node zelf of op enige diepte een afstammeling ervan is; anders geeft ze false terug. Voor null is het resultaat false.
Het argument staat voor een node, niet voor een CSS-selector of zoektekst. Ook een tekstnode kan een afstammeling zijn. Gebruik node !== other && node.contains(other) om de node zelf uit te sluiten.
De huidige DOM-boom is bepalend, niet de zichtbaarheid. De boom hoeft niet aan het document gekoppeld te zijn. De methode overschrijdt geen grenzen van de Shadow DOM: een afstammeling binnen een shadow root is daardoor geen afstammeling van de host. Dit is een Web API uit de DOM-standaard, geen functie van de ECMAScript-taal.
Voorbeelden
const root = document.createElement('div');
const child = document.createElement('span');
const text = document.createTextNode('Hello');
root.appendChild(child);
child.appendChild(text);
console.log(root.contains(root));
console.log(root.contains(child));
console.log(root.contains(text));
console.log(child.contains(root));
console.log(root.contains(null));
child.remove();
console.log(root.contains(text));Resultaat
true true true false false false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.