Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti