CKTIS / JavaScript
DOMException DataCloneError — pogreška pri kloniranju podataka
DataCloneError naziv je iznimke DOMException koja označava da se podaci ne mogu klonirati. Saznajte koji je čest uzrok pri uporabi structuredClone(), kako prepoznati pogrešku i po čemu se nepodržana vrijednost razlikuje od podržane kružne reference.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
structuredClone(value)
structuredClone(value, options)
error.name === "DataCloneError"DataCloneError DOMException označava objekt DOMException čiji je name "DataCloneError", a ne zaseban konstruktor DataCloneError. Povijesni kod je 25 (DATA_CLONE_ERR); pogrešku prepoznajte prema name, a ne prema zastarjelom brojčanom kodu.
structuredClone() sinkrono izbacuje ovu iznimku ako se bilo koji dio podataka koje treba klonirati ne može serijalizirati algoritmom strukturiranog kloniranja. Funkcije i DOM čvorovi nisu podržani, čak ni unutar običnog objekta. Kružne reference same po sebi ne uzrokuju pogrešku: algoritam ih može sačuvati. Taj se algoritam upotrebljava i za slanje podataka pomoću postMessage() između Workera te za pohranu vrijednosti u IndexedDB.
U primjeru task sadrži funkciju pa prvo kloniranje izbacuje iznimku. Blok catch obrađuje samo očekivanu pogrešku, a sve ostale ponovno izbacuje. Drugo kloniranje odabire samo podatke. Umjesto funkcija ili DOM čvorova prosljeđujte podržane vrijednosti. Nemojte temeljiti test na cijelom tekstu message.
Ovo je mehanizam Web API-ja, a ne značajka dodijeljena određenom izdanju ECMAScripta. MDN navodi da je structuredClone() dostupan u glavnim preglednicima od ožujka 2022.; provjerite kompatibilnost za ciljano okruženje. To što se Node 24 nalazi u repozitoriju ne dokazuje podršku API-ja u pregledniku.
Primjeri
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);Rezultat
DataCloneError 3
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.