Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje