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.