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

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.

Sources