База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

DOMException DataCloneError — грешка при клониране на данни

DataCloneError е името на изключение DOMException, което показва, че данните не могат да бъдат клонирани. Научете за честа причина при structuredClone(), как да разпознаете грешката и защо неподдържаната стойност се различава от поддържаната циклична препратка.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

DataCloneError DOMException означава обект DOMException, чието name е "DataCloneError", а не отделен конструктор DataCloneError. Историческият код е 25 (DATA_CLONE_ERR); разпознавайте грешката по name, а не по остарелия числов код.

structuredClone() хвърля това изключение синхронно, ако която и да е част от данните за клониране не може да бъде сериализирана чрез алгоритъма за структурирано клониране. Функциите и DOM възлите не се поддържат, включително когато са в обикновен обект. Самите циклични препратки не причиняват грешка: алгоритъмът може да ги запази. Този алгоритъм се използва и за изпращане на данни чрез postMessage() между Workers и за съхраняване на стойности в IndexedDB.

В примера task съдържа функция, затова първото клониране хвърля изключение. Блокът catch обработва само очакваната грешка, а всяка друга хвърля отново. Второто клониране избира само данни. Подайте поддържани стойности вместо функции или DOM възли. Не обвързвайте теста с пълния текст на message.

Това е механизъм на Web API, а не функция, присвоена на конкретно издание на ECMAScript. MDN посочва, че structuredClone() е наличен в основните браузъри от март 2022 г.; проверете съвместимостта за целевата среда. Наличието на Node 24 в хранилище не доказва поддръжка на API в браузъра.

Примери

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

Резултат

DataCloneError
3

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници