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

CKTIS / JavaScript

Element.replaceChildren() — remplacer tous les enfants

Element.replaceChildren() remplace les enfants d’un élément par les nœuds et chaînes de caractères fournis en arguments. Sans argument, la méthode supprime tous les enfants.

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

element.replaceChildren(...nodes)

Element.replaceChildren provient du mixin ParentNode de la norme DOM, et non d’ECMAScript. La méthode remplace tous les enfants d’un élément tout en laissant l’élément lui-même intact. Elle renvoie undefined.

Les arguments sont des nœuds ou des chaînes de caractères, traités dans l’ordre où ils sont fournis. Les chaînes deviennent des nœuds Text ; elles ne sont pas analysées comme du HTML. Les nœuds existants sont déplacés, et non clonés. Si le même nœud est passé une nouvelle fois, il est déplacé au lieu d’ajouter un enfant supplémentaire. Si a et b sont deux éléments distincts, après element.replaceChildren(a, b, a), les enfants sont b puis a. element.replaceChildren() supprime tous les enfants.

Une hiérarchie invalide, par exemple l’insertion d’un élément dans lui-même, déclenche une DOMException nommée HierarchyRequestError.

Il s’agit d’une API du DOM des navigateurs ; la présence de Node 24 ne prouve pas qu’elle est disponible. Vérifiez dans l’environnement cible typeof Element !== 'undefined' && typeof Element.prototype.replaceChildren === 'function'.

Exemples

const box = document.createElement('div');
box.textContent = 'Old';
const label = document.createElement('strong');
label.textContent = 'New';

box.replaceChildren('Status: ', label);
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(box.lastChild === label);

box.replaceChildren();
console.log(box.childNodes.length);

Résultat

Status: New
2
true
0

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