CKTIS / JavaScript
Node.appendChild — ajouter un nœud
Node.appendChild ajoute un nœud comme dernier enfant d’un parent. La méthode renvoie le nœud fourni et déplace un nœud déjà existant au lieu de le copier.
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
parent.appendChild(node)parent.appendChild(node) accepte un seul Node et renvoie ce même objet. Il s’agit d’une API DOM, et non d’une fonction ECMAScript.
Si node a déjà un parent, il est déplacé, pas copié. Ajouter à nouveau un enfant existant le déplace à la fin. Avec un DocumentFragment, ses enfants sont déplacés dans leur ordre actuel ; le fragment renvoyé devient vide.
Une hiérarchie invalide, par exemple l’insertion d’un ancêtre dans l’un de ses descendants, provoque une HierarchyRequestError. Contrairement à append(), cette méthode n’accepte ni texte ni plusieurs arguments sous forme de liste de nœuds.
L’exemple nécessite un DOM de navigateur ; une version Node.js seule ne suffit pas à établir la prise en charge de cette API. Le résultat BA montre le déplacement de first.
Exemples
const parent = document.createElement('div');
const first = document.createElement('span');
first.textContent = 'A';
const second = document.createElement('span');
second.textContent = 'B';
parent.appendChild(first);
parent.appendChild(second);
const returned = parent.appendChild(first);
console.log(parent.textContent);
console.log(returned === first);
console.log(parent.childNodes.length);Résultat
BA true 2
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.