Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Node.firstChild — le premier nœud enfant

Node.firstChild est une propriété en lecture seule qui renvoie le premier nœud enfant direct ou null. Elle inclut aussi le texte et les commentaires : le nœud renvoyé n’est donc pas nécessairement un élément.

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

Syntaxe

node.firstChild

Node.firstChild lit le premier nœud enfant direct dans l’ordre de l’arbre, et non le premier élément à n’importe quelle profondeur. La propriété renvoie un objet Node, ou null si le nœud n’a pas d’enfants. C’est une propriété en lecture seule, pas une méthode : utilisez node.firstChild, sans parenthèses d’appel.

Un enfant peut être un élément, un nœud Text ou un nœud Comment. Le texte composé uniquement d’espaces blancs compte également. Si vous avez besoin du premier enfant qui est un élément, utilisez firstElementChild sur un Element, un Document ou un DocumentFragment ; cette propriété ignore le texte et les commentaires.

Vérifiez que le résultat n’est pas null avant d’accéder à ses propriétés. La lecture ne crée pas de copie : vous pouvez modifier le nœud renvoyé. Après l’ajout ou la suppression d’enfants, une nouvelle lecture de firstChild reflète l’arbre actuel ; une référence enregistrée auparavant ne se reporte pas sur le nouvel enfant en première position.

L’exemple crée un élément détaché, ajoute du texte composé d’espaces blancs et un élément, puis supprime les enfants. Il nécessite un environnement DOM de navigateur. Il s’agit d’une API de la norme DOM, et non d’une fonctionnalité d’une édition particulière d’ECMAScript ; la version de Node.js d’un dépôt ne prouve pas la prise en charge des API de navigateur.

Exemples

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

Résultat

true
true
true
true
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources