Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti