Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti