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

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.

Sources