DataCloneError: Failed to execute 'structuredClone' on 'Window': () => {} could not be cloned.
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ă
const cos = { produse: [], total() { return 0; } };
const copie = structuredClone(cos);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
const setari = { tema: "dark", onChange: () => {} };
worker.postMessage(setari);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
structuredClone({ buton: document.querySelector("button") });structuredClone({ butonId: "salveaza" });Elementele DOM nu se pot copia; trimite un identificator.
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.
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`);Original: 1 produse Copie: 2 produse
Indiciu
Clonează doar datele coșului, fără metoda total.
Reparația
const cos = {
produse: [{ nume: "Pâine", pret: 5 }],
total() {
return this.produse.reduce((s, p) => s + p.pret, 0);
},
};
const copie = structuredClone({ produse: cos.produse });
copie.produse.push({ nume: "Lapte", pret: 8 });
console.log(`Original: ${cos.produse.length} produse`);
console.log(`Copie: ${copie.produse.length} produse`);De ce merge
structuredClone copiază date, nu cod. Metoda total e o funcție, așa că algoritmul de clonare a aruncat DataCloneError. Clonând doar { produse: cos.produse }, copia primește un tablou nou, cu obiecte noi, independent de original: adăugarea laptelui schimbă doar copia. Dacă ai nevoie de total și pe copie, o calculezi cu o funcție separată care primește lista.
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
structuredClonesaupostMessage, extrage doar câmpurile de date. - Pentru instanțe de clasă, adaugă
toJSON()/static fromJSON()sau reconstruiește cunew. - 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
TypeError: Converting circular structure to JSON `JSON.stringify` a dat peste un obiect care se conține pe el însuși, direct sau printr-un lanț (de exemplu un copil cu referință la părinte). JSON nu poate reprezenta cicluri. Serializează doar câmpurile de care ai nevoie, elimină referința înapoi sau folosește un replacer. TypeError: Do not know how to serialize a BigInt `JSON.stringify` a găsit o valoare `BigInt` (de exemplu `123n`), pe care JSON nu știe să o reprezinte. Transform-o în text (`valoare.toString()`) sau în număr, cu un replacer, înainte de serializare. TypeError: 'set' on proxy: trap returned falsish for property 'pret' Capcana set a unui Proxy nu a întors true. În strict mode, dacă set întoarce false sau nimic (undefined), atribuirea e considerată eșuată și aruncă această eroare. Pune return true; la finalul capcanei după ce salvezi valoarea (sau return Reflect.set(...)). Î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.
