Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Node.firstChild — o primeiro nó filho

Node.firstChild é uma propriedade só de leitura que devolve o primeiro nó filho direto ou null. Inclui também texto e comentários, pelo que o nó devolvido não é necessariamente um elemento.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

node.firstChild

Node.firstChild lê o primeiro nó filho direto pela ordem da árvore, e não o primeiro elemento a qualquer profundidade. Devolve um objeto Node ou null se o nó não tiver filhos. É uma propriedade só de leitura, não um método: utilize node.firstChild, sem parênteses de chamada.

Um filho pode ser um elemento, um nó Text ou um nó Comment. O texto constituído apenas por espaços em branco também conta. Se precisar do primeiro filho que seja um elemento, utilize firstElementChild num Element, Document ou DocumentFragment; esta propriedade ignora o texto e os comentários.

Verifique se o resultado é null antes de aceder às respetivas propriedades. A leitura não cria uma cópia: pode modificar o nó devolvido. Depois de adicionar ou remover filhos, uma nova leitura de firstChild reflete a árvore atual; uma referência guardada anteriormente não passa a apontar para o novo primeiro filho.

O exemplo cria um elemento desligado, adiciona texto com espaços em branco e um elemento e, em seguida, remove os filhos. Requer um ambiente DOM de navegador. Esta é uma API do padrão DOM, não uma funcionalidade de uma edição específica do ECMAScript; a versão de Node.js num repositório não comprova o suporte de APIs do navegador.

Exemplos

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);

Resultado

true
true
true
true
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes