Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje