CKTIS / JavaScript
Node.contains — verificare l’appartenenza all’albero DOM
Node.contains verifica se un nodo specificato è il nodo stesso o un suo discendente a qualsiasi profondità. Restituisce un valore booleano.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
node.contains(other)Node.contains è un metodo di istanza di Node, chiamato come node.contains(other). Restituisce true quando other è node stesso oppure un suo discendente a qualsiasi profondità; altrimenti restituisce false. Per null, il risultato è false.
L’argomento rappresenta un nodo, non un selettore CSS né un testo da cercare. Anche un nodo di testo può essere un discendente. Per escludere il nodo stesso, usa node !== other && node.contains(other).
Conta l’albero DOM attuale, non la visibilità. L’albero non deve necessariamente essere collegato al documento. Il metodo non oltrepassa i confini dello Shadow DOM: un discendente all’interno di uno shadow root non è per questo un discendente del suo host. È una Web API dello standard DOM, non una funzionalità del linguaggio ECMAScript.
Esempi
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));Risultato
true true true false false false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.