CKTIS / JavaScript
DOMException DataCloneError — chyba pri klonovaní údajov
DataCloneError je názov výnimky DOMException, ktorá signalizuje, že údaje nemožno klonovať. Zistite, aká je častá príčina pri structuredClone(), ako chybu rozpoznať a prečo sa nepodporovaná hodnota líši od podporovaného cyklického odkazu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
structuredClone(value)
structuredClone(value, options)
error.name === "DataCloneError"DataCloneError DOMException označuje objekt DOMException, ktorého name má hodnotu "DataCloneError"; nejde o samostatný konštruktor DataCloneError. Historický kód je 25 (DATA_CLONE_ERR); chybu rozpoznávajte podľa name, nie podľa zastaraného číselného kódu.
structuredClone() vyvolá túto výnimku synchrónne, ak niektorú časť klonovaných údajov nemožno serializovať algoritmom štruktúrovaného klonovania. Funkcie a uzly DOM nie sú podporované, a to ani vnútri bežného objektu. Samotné cyklické odkazy chybu nespôsobujú: algoritmus ich dokáže zachovať. Tento algoritmus sa používa aj na odosielanie údajov pomocou postMessage() medzi Workermi a na ukladanie hodnôt do IndexedDB.
V príklade obsahuje task funkciu, takže prvé klonovanie vyvolá výnimku. Blok catch spracuje iba očakávanú chybu a všetky ostatné znova vyvolá. Druhé klonovanie vyberá iba údaje. Odovzdávajte podporované hodnoty namiesto funkcií alebo uzlov DOM. Nezakladajte test na celom texte message.
Ide o mechanizmus Web API, nie o funkciu priradenú ku konkrétnej edícii ECMAScriptu. MDN uvádza, že structuredClone() je v hlavných prehliadačoch dostupné od marca 2022; overte kompatibilitu pre cieľové prostredie. Prítomnosť Node 24 v repozitári nedokazuje podporu API v prehliadači.
Príklady
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);Výsledok
DataCloneError 3
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.