Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

DOMException DataCloneError — napaka pri kloniranju podatkov

DataCloneError je ime izjeme DOMException, ki sporoča, da podatkov ni mogoče klonirati. Spoznajte pogost vzrok pri uporabi structuredClone(), način prepoznavanja napake in razliko med nepodprto vrednostjo ter podprto krožno referenco.

Različica: 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čuje objekt DOMException, katerega name je "DataCloneError"; ne gre za ločen konstruktor DataCloneError. Zgodovinska koda je 25 (DATA_CLONE_ERR); napako prepoznajte po name, ne po zastareli številski kodi.

structuredClone() to izjemo sproži sinhrono, kadar katerega koli dela podatkov, ki jih kloniramo, ni mogoče serializirati z algoritmom strukturiranega kloniranja. Funkcije in vozlišča DOM niso podprti, tudi če so znotraj običajnega objekta. Krožne reference same po sebi ne povzročijo napake: algoritem jih lahko ohrani. Ta algoritem se uporablja tudi za pošiljanje podatkov z postMessage() med Workerji in shranjevanje vrednosti v IndexedDB.

V primeru task vsebuje funkcijo, zato prvo kloniranje sproži izjemo. Blok catch obdela samo pričakovano napako, vse druge pa znova sproži. Drugo kloniranje izbere samo podatke. Namesto funkcij ali vozlišč DOM posredujte podprte vrednosti. Testa ne vežite na celotno besedilo message.

To je mehanizem Web API, ne funkcija, vezana na določeno izdajo ECMAScripta. MDN navaja, da je structuredClone() v glavnih brskalnikih na voljo od marca 2022; preverite združljivost za ciljno okolje. Prisotnost Node 24 v repozitoriju ne dokazuje podpore za API v brskalniku.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri