Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.replaceWith — sostituire un elemento

Element.replaceWith sostituisce un elemento all’interno del suo genitore con nodi e testo. Le stringhe diventano testo, non markup HTML.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

element.replaceWith(...nodes)

Element.replaceWith proviene dal mixin ChildNode dello standard DOM, non da un’edizione di ECMAScript. La chiamata element.replaceWith(...nodes) sostituisce l’elemento stesso, non i suoi figli; replaceChildren(...nodes) modifica i figli.

Gli argomenti sono nodi e stringhe, nell’ordine indicato. I nodi vengono spostati, non copiati; le stringhe creano nodi Text senza analizzare l’HTML. Il metodo restituisce undefined. La chiamata senza argomenti rimuove l’elemento; se non ha un genitore, non apporta modifiche.

Una struttura ad albero non valida può causare HierarchyRequestError. Verifica la disponibilità con typeof Element.prototype.replaceWith === 'function' in un ambiente DOM; la sola versione di Node.js non dimostra che la funzione sia supportata.

Esempi

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);

Risultato

new <text>
true
true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti