Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.replaceChildren() — sostituire tutti i nodi figli

Element.replaceChildren() sostituisce i nodi figli di un elemento con i nodi e le stringhe passati come argomenti. Se viene chiamato senza argomenti, rimuove tutti i nodi figli.

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.replaceChildren(...nodes)

Element.replaceChildren proviene dal mixin ParentNode dello standard DOM, non da ECMAScript. Sostituisce tutti i nodi figli di un elemento, lasciando intatto l’elemento stesso. Restituisce undefined.

Gli argomenti sono nodi o stringhe e vengono elaborati nell’ordine in cui sono forniti. Le stringhe diventano nodi Text, non vengono analizzate come HTML. I nodi esistenti vengono spostati, non clonati. Se si passa di nuovo lo stesso nodo, questo viene spostato invece di aggiungere un altro figlio. Se a e b sono elementi distinti, dopo element.replaceChildren(a, b, a) rimangono b e poi a. element.replaceChildren() rimuove tutti i nodi figli.

Una gerarchia non valida, per esempio l’inserimento di un elemento al suo interno, genera una DOMException denominata HierarchyRequestError.

Questa è un’API del DOM dei browser; la presenza di Node 24 non ne dimostra la disponibilità. Nell’ambiente di destinazione, verifica typeof Element !== 'undefined' && typeof Element.prototype.replaceChildren === 'function'.

Esempi

const box = document.createElement('div');
box.textContent = 'Old';
const label = document.createElement('strong');
label.textContent = 'New';

box.replaceChildren('Status: ', label);
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(box.lastChild === label);

box.replaceChildren();
console.log(box.childNodes.length);

Risultato

Status: New
2
true
0

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