CKTIS / JavaScript
Node.firstChild — il primo nodo figlio
Node.firstChild è una proprietà di sola lettura che restituisce il primo nodo figlio diretto oppure null. Include anche testo e commenti, quindi il nodo restituito non è necessariamente un elemento.
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.firstChildNode.firstChild legge il primo nodo figlio diretto nell’ordine dell’albero, non il primo elemento a qualsiasi profondità. Restituisce un oggetto Node oppure null se il nodo non ha figli. È una proprietà di sola lettura, non un metodo: usa node.firstChild, senza parentesi di chiamata.
Un figlio può essere un elemento, un nodo Text o un nodo Comment. Anche il testo composto solo da spazi vuoti viene considerato. Se ti serve il primo figlio che sia un elemento, usa firstElementChild su un Element, Document o DocumentFragment; questa proprietà ignora testo e commenti.
Controlla che il risultato non sia null prima di accedere alle sue proprietà. La lettura non crea una copia: puoi modificare il nodo restituito. Dopo aver aggiunto o rimosso figli, una nuova lettura di firstChild riflette l’albero corrente; un riferimento salvato in precedenza non passa al nuovo primo figlio.
L’esempio crea un elemento scollegato, aggiunge testo composto da spazi vuoti e un elemento, quindi rimuove i figli. Richiede un ambiente DOM del browser. Questa è un’API dello standard DOM, non una funzionalità di una specifica edizione di ECMAScript; la versione di Node.js in un repository non dimostra il supporto delle API del browser.
Esempi
const parent = document.createElement('div');
const text = document.createTextNode('\n ');
const element = document.createElement('span');
parent.append(text, element);
console.log(parent.firstChild === text);
console.log(parent.firstChild.nodeType === Node.TEXT_NODE);
console.log(parent.firstElementChild === element);
parent.removeChild(text);
console.log(parent.firstChild === element);
parent.removeChild(element);
console.log(parent.firstChild === null);Risultato
true true true true true
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.