CKTIS / JavaScript
Node.replaceChild — sostituire un figlio
Node.replaceChild sostituisce un figlio diretto di un nodo padre e restituisce il nodo rimosso. Il nodo sostitutivo va fornito come primo argomento.
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
const removedNode = parent.replaceChild(newChild, oldChild);parent.replaceChild(newChild, oldChild) sostituisce oldChild con newChild e restituisce oldChild. Gli argomenti devono essere nodi, non stringhe. È un’API DOM, non una funzionalità di ECMAScript.
Se newChild esiste già, viene spostato, non copiato. Un DocumentFragment inserisce i suoi figli invece del frammento stesso.
Una struttura non valida, come un ciclo, può causare HierarchyRequestError. Il metodo verifica se la sostituzione creerebbe un ciclo prima di verificare se oldChild è un figlio diretto di parent. Se i controlli precedenti non rilevano errori e oldChild non è un figlio diretto di parent, il metodo genera NotFoundError.
Esempi
const parent = document.createElement('div');
const oldChild = document.createTextNode('old');
const newChild = document.createTextNode('new');
parent.appendChild(oldChild);
const removedNode = parent.replaceChild(newChild, oldChild);
console.log(parent.textContent);
console.log(removedNode === oldChild);
console.log(oldChild.parentNode === null);Risultato
new 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.