CKTIS / JavaScript
Element.replaceWith — remplacer un élément
Element.replaceWith remplace un élément dans son parent par des nœuds et du texte. Les chaînes deviennent du texte, et non du code HTML.
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.replaceWith(...nodes)Element.replaceWith provient du mixin ChildNode du standard DOM, et non d’une édition d’ECMAScript. L’appel element.replaceWith(...nodes) remplace l’élément lui-même, pas ses enfants ; replaceChildren(...nodes) modifie les enfants.
Les arguments sont des nœuds et des chaînes, dans l’ordre indiqué. Les nœuds sont déplacés, et non copiés ; les chaînes créent des nœuds Text sans analyser le HTML. La méthode renvoie undefined. Un appel sans argument supprime l’élément ; s’il n’a pas de parent, il ne modifie rien.
Une structure d’arbre non valide peut provoquer HierarchyRequestError. Vérifiez la disponibilité avec typeof Element.prototype.replaceWith === 'function' dans un environnement DOM ; la version de Node.js, à elle seule, ne permet pas d’établir la prise en charge.
Exemples
const container = document.createElement('div');
const oldElement = document.createElement('span');
oldElement.textContent = 'old';
container.appendChild(oldElement);
const replacement = document.createElement('strong');
replacement.textContent = 'new';
const result = oldElement.replaceWith(replacement, ' <text>');
console.log(container.textContent);
console.log(container.firstChild === replacement);
console.log(oldElement.parentNode === null);
console.log(result === undefined);Résultat
new <text> true 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.