...
Eroare JavaScript · Obiecte și clase

DataCloneError: Failed to execute 'structuredClone' on 'Window': () => {} could not be cloned.

Pe scurt

structuredClone (sau postMessage către un worker) a dat peste ceva ce nu se poate copia: o funcție sau o metodă, un element DOM, o promisiune, un Proxy. Copiază doar datele: scoate funcțiile din obiect înainte de clonare sau recreează obiectul după.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

structuredClone(obj) face o copie în profunzime a datelor: obiecte, tablouri, texte, numere, Date, Map, Set, RegExp, tablouri tipizate, Blob. Nu poate copia cod sau resurse vii: funcții (inclusiv metodele din obiect), elemente DOM, promisiuni, Proxy, WeakMap, simboluri. Când întâlnește una, aruncă o DOMException cu numele DataCloneError, iar mesajul conține chiar valoarea problematică (de exemplu codul funcției: total() { ... } could not be cloned.).

Același algoritm e folosit de postMessage (workeri, iframe-uri), history.pushState și IndexedDB, deci eroarea apare și acolo.

Ce nu dă eroare, dar se pierde: prototipul. Un obiect creat cu new Cont() devine după clonare un obiect simplu, fără metodele clasei. Dacă ai nevoie de instanțe, clonează datele și construiește din nou obiectul cu new.

De ce apare: cauzele frecvente

1Obiect cu o metodă

Greșit
JavaScript
const cos = { produse: [], total() { return 0; } };
const copie = structuredClone(cos);
Corect
JavaScript
const { total, ...date } = cos;
const copie = structuredClone(date);

Fără funcție, obiectul conține doar date, pe care structuredClone le copiază.

2Obiect cu un callback salvat

Greșit
JavaScript
const setari = { tema: "dark", onChange: () => {} };
worker.postMessage(setari);
Corect
JavaScript
const setari = { tema: "dark", onChange: () => {} };
worker.postMessage({ tema: setari.tema });

La worker trimiți doar date; logica rămâne în fiecare parte.

3Element DOM sau promisiune în date

Greșit
JavaScript
structuredClone({ buton: document.querySelector("button") });
Corect
JavaScript
structuredClone({ butonId: "salveaza" });

Elementele DOM nu se pot copia; trimite un identificator.

Repară tu

Repară eroarea, direct în pagină

Programul face o copie a coșului cu structuredClone, ca să adauge un produs fără să schimbe originalul, dar se oprește cu DataCloneError: ... could not be cloned. Repară clonarea ca programul să afișeze Original: 1 produse și Copie: 2 produse.

Codul care dă eroarea
JavaScript
const cos = {
  produse: [{ nume: "Pâine", pret: 5 }],
  total() {
    return this.produse.reduce((s, p) => s + p.pret, 0);
  },
};

const copie = structuredClone(cos);
copie.produse.push({ nume: "Lapte", pret: 8 });

console.log(`Original: ${cos.produse.length} produse`);
console.log(`Copie: ${copie.produse.length} produse`);
După reparație, programul afișează
Original: 1 produse
Copie: 2 produse
Indiciu

Clonează doar datele coșului, fără metoda total.

Alte forme ale mesajului

  • DOMException [DataCloneError]: () => {} could not be cloned.
  • DataCloneError: Failed to execute 'postMessage' on 'Worker': () => {} could not be cloned.
  • DataCloneError: Failed to execute 'structuredClone' on 'Window': #<Promise> could not be cloned.
  • DataCloneError: The object could not be cloned.

Cum o eviți pe viitor

  • Păstrează datele separat de logică: obiecte simple pentru stare, funcții în module.
  • Înainte de structuredClone sau postMessage, extrage doar câmpurile de date.
  • Pentru instanțe de clasă, adaugă toJSON() / static fromJSON() sau reconstruiește cu new.
  • Nu pune elemente DOM, promisiuni sau Proxy-uri în starea pe care o copiezi.

Întrebări frecvente

JSON.parse(JSON.stringify(obj)) nu dă eroare. De ce?

JSON.stringify ignoră în tăcere funcțiile și undefined, deci le pierzi fără să afli. Pierde și Date (devine text), Map și Set. structuredClone păstrează mai multe tipuri, dar te anunță când ceva nu se poate copia.

Un obiect Vue sau MobX dă aceeași eroare. De ce?

Stările reactive sunt deseori Proxy-uri, care nu se pot clona. Transformă-le întâi în obiecte simple (de exemplu cu toRaw sau toJS, după bibliotecă).

Erori înrudite

← Toate erorile JavaScript

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață JavaScript de la zero, cu exerciții la fiecare lecție

Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.