CKTIS / JavaScript
Node.replaceChild — remplacer un enfant
Node.replaceChild remplace un enfant direct d’un parent et renvoie le nœud supprimé. Le nœud de remplacement est fourni en premier argument.
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
const removedNode = parent.replaceChild(newChild, oldChild);parent.replaceChild(newChild, oldChild) remplace oldChild par newChild et renvoie oldChild. Les arguments doivent être des nœuds, et non des chaînes de caractères. Il s’agit d’une API DOM, pas d’une fonctionnalité ECMAScript.
Si newChild existe déjà, il est déplacé et non copié. Un DocumentFragment insère ses enfants plutôt que le fragment lui-même.
Une structure non valide, comme un cycle, peut déclencher une erreur HierarchyRequestError. La méthode vérifie si le remplacement créerait un cycle avant de vérifier si oldChild est un enfant direct de parent. Si les vérifications précédentes ne détectent aucune erreur et que oldChild n’est pas un enfant direct de parent, la méthode déclenche une erreur NotFoundError.
Exemples
const parent = document.createElement('div');
const oldChild = document.createTextNode('old');
const newChild = document.createTextNode('new');
parent.appendChild(oldChild);
const removedNode = parent.replaceChild(newChild, oldChild);
console.log(parent.textContent);
console.log(removedNode === oldChild);
console.log(oldChild.parentNode === null);Résultat
new 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.