CKTIS / JavaScript
DOMException DataCloneError — errore nella clonazione dei dati
DataCloneError è il nome di una DOMException che indica che i dati non possono essere clonati. Scopri una causa tipica con structuredClone(), come riconoscere l’errore e perché un valore non supportato è diverso da un riferimento circolare supportato.
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
structuredClone(value)
structuredClone(value, options)
error.name === "DataCloneError"DataCloneError DOMException indica un oggetto DOMException il cui name è "DataCloneError", non un costruttore DataCloneError separato. Il codice storico è 25 (DATA_CLONE_ERR); identifica l’errore tramite name, non con il codice numerico obsoleto.
structuredClone() genera questa eccezione in modo sincrono quando una qualsiasi parte dei dati da clonare non è serializzabile con l’algoritmo di clonazione strutturata. Le funzioni e i nodi DOM non sono supportati, nemmeno all’interno di un normale oggetto. I riferimenti circolari, da soli, non causano un errore: l’algoritmo può conservarli. Questo algoritmo viene usato anche per inviare dati con postMessage() tra Worker e per memorizzare valori in IndexedDB.
Nell’esempio, task contiene una funzione, quindi il primo tentativo di clonazione genera un’eccezione. Il blocco catch gestisce solo l’errore previsto e rilancia qualsiasi altro errore. La seconda clonazione seleziona solo dati. Passa valori supportati invece di funzioni o nodi DOM. Non basare il test sul testo completo di message.
Questo è un meccanismo di Web API, non una funzionalità assegnata a una specifica edizione di ECMAScript. MDN indica che structuredClone() è disponibile nei principali browser da marzo 2022; verifica la compatibilità con l’ambiente di destinazione. La presenza di Node 24 in un repository non dimostra che l’API sia supportata nel browser.
Esempi
const value = { count: 3, task: () => 42 };
try {
structuredClone(value);
} catch (error) {
if (!(error instanceof DOMException) || error.name !== "DataCloneError") {
throw error;
}
console.log(error.name);
}
const copy = structuredClone({ count: value.count });
console.log(copy.count);Risultato
DataCloneError 3
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.