CKTIS / JavaScript
DOMException DataCloneError — chyba při klonování dat
DataCloneError je název výjimky DOMException, která oznamuje, že data nelze naklonovat. Seznamte se s častou příčinou při použití structuredClone(), způsobem rozpoznání chyby a rozdílem mezi nepodporovanou hodnotou a podporovaným cyklickým odkazem.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
structuredClone(value)
structuredClone(value, options)
error.name === "DataCloneError"DataCloneError DOMException označuje objekt DOMException, jehož name má hodnotu "DataCloneError"; nejde o samostatný konstruktor DataCloneError. Historický kód je 25 (DATA_CLONE_ERR); chybu rozpoznávejte podle name, nikoli podle zastaralého číselného kódu.
structuredClone() tuto výjimku vyvolá synchronně, pokud některou část klonovaných dat nelze serializovat pomocí algoritmu strukturovaného klonování. Funkce a uzly DOM nejsou podporované, a to ani uvnitř běžného objektu. Samotné cyklické odkazy chybu nezpůsobují: algoritmus je dokáže zachovat. Tento algoritmus se používá také k odesílání dat pomocí postMessage() mezi Workery a k ukládání hodnot do IndexedDB.
V příkladu obsahuje task funkci, takže první klonování vyvolá výjimku. Blok catch zpracuje pouze očekávanou chybu a všechny ostatní znovu vyvolá. Druhé klonování vybírá pouze data. Předávejte podporované hodnoty místo funkcí nebo uzlů DOM. Nezakládejte test na celém textu message.
Jde o mechanismus Web API, nikoli o funkci přiřazenou ke konkrétní edici ECMAScriptu. MDN uvádí, že structuredClone() je v hlavních prohlížečích dostupné od března 2022; ověřte kompatibilitu pro cílové prostředí. Přítomnost Node 24 v repozitáři nedokazuje podporu API v prohlížeči.
Pří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ýsledek
DataCloneError 3
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.