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

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.

Sources