Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori