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