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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.