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

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.

Sources