CKTIS / JavaScript
Node.removeChild() : détacher un nœud enfant
La méthode parent.removeChild(child) détache un enfant direct de son parent et renvoie le même nœud, qui peut être inséré à nouveau.
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.removeChild(child)Node.removeChild est une méthode d’instance de l’interface Node, définie par la norme DOM et non par ECMAScript. Appelez parent.removeChild(child) sur le parent ; child peut aussi être un nœud texte.
La méthode renvoie le même objet child. Après son détachement, son parentNode vaut null ; le nœud conservé peut être réinséré avec appendChild. Le détachement ne détruit ni l’objet ni son sous-arbre.
Si child est un Node mais n’est pas un enfant direct de parent, la méthode lève une DOMException nommée NotFoundError. C’est notamment le cas si l’on passe un descendant plus éloigné ou si l’on tente de retirer à nouveau un enfant déjà détaché. Passer null lève une TypeError lors de la conversion de l’argument selon les règles de Web IDL, avant la vérification du parent. L’exemple nécessite un DOM de navigateur ; une version de Node.js à elle seule ne prouve pas que cette API est disponible.
Exemples
const parent = document.createElement('div');
const child = document.createTextNode('Hello');
parent.appendChild(child);
const removed = parent.removeChild(child);
console.log(removed === child);
console.log(child.parentNode === null);
console.log(parent.childNodes.length);
parent.appendChild(removed);
console.log(parent.textContent);Résultat
true true 0 Hello
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.