Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DataCloneError DOMException — błąd klonowania danych

DataCloneError to nazwa wyjątku DOMException sygnalizującego, że danych nie można sklonować. Poznaj typową przyczynę w structuredClone(), sposób rozpoznawania błędu i różnicę między niedozwoloną wartością a obsługiwanym cyklem referencji.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

structuredClone(value)
structuredClone(value, options)
error.name === "DataCloneError"

DataCloneError DOMException oznacza obiekt DOMException, którego name wynosi "DataCloneError", a nie osobny konstruktor DataCloneError. Historyczny kod to 25 (DATA_CLONE_ERR); do rozpoznawania błędu używaj name, nie przestarzałego kodu liczbowego.

structuredClone() zgłasza ten wyjątek synchronicznie, gdy jakakolwiek część klonowanych danych nie nadaje się do serializacji strukturalnej. Funkcje i węzły DOM nie są obsługiwane, także wewnątrz zwykłego obiektu. Same cykle referencji nie powodują błędu: algorytm potrafi je zachować. Ten algorytm służy również do przesyłania danych przez postMessage() między Workerami i zapisywania wartości w IndexedDB.

W przykładzie pole task zawiera funkcję, więc pierwsze klonowanie kończy się wyjątkiem. catch obsługuje tylko oczekiwany błąd, a inne zgłasza ponownie. Drugie klonowanie wybiera wyłącznie dane. Przekazuj obsługiwane wartości zamiast funkcji lub węzłów DOM. Nie uzależniaj testu od pełnego tekstu message.

To mechanizm Web API, nie funkcja przypisana do konkretnej edycji ECMAScript. MDN wskazuje dostępność structuredClone() w głównych przeglądarkach od marca 2022; sprawdź zgodność dla środowiska docelowego. Obecność Node 24 w repozytorium nie dowodzi obsługi API w przeglądarce.

Przykłady

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);

Wynik

DataCloneError
3

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła