Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.firstChild

Node.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.

Fonti