TypeError: Cannot freeze array buffer views with elements
Object.freeze (sau Object.seal) nu poate îngheța un tablou tipizat care are elemente, de exemplu un Uint8Array, pentru că memoria lui poate fi modificată și prin buffer. Dacă vrei date nemodificabile, copiază-le într-un tablou obișnuit și îngheață-l pe acela, sau expune doar o funcție de citire.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Object.freeze(obj) face un obiect complet nemodificabil, inclusiv elementele lui. La tablourile tipizate (Uint8Array, Float32Array, DataView...) asta nu e posibil: elementele nu stau în obiect, ci într-un ArrayBuffer care poate fi citit și scris și prin alte ferestre (new Uint8Array(acelasiBuffer)). Motorul nu poate garanta înghețarea, așa că aruncă Cannot freeze array buffer views with elements. Object.seal dă un mesaj similar (Cannot seal array buffer views with elements). Un tablou tipizat gol poate fi înghețat, pentru că nu are elemente.
Greșeala apare când ai o funcție generică de tip ingheataAdanc(obj) care parcurge recursiv un obiect cu date binare (o imagine, un fișier încărcat), sau când vrei să protejezi un tabel de constante scris ca Uint8Array.
Variantele corecte: un tablou obișnuit înghețat (Object.freeze(Array.from(date))) pentru date mici; o copie la fiecare citire (date.slice()) ca să nu se modifice originalul; sau sărirea tablourilor tipizate în funcția de înghețare adâncă (ArrayBuffer.isView(x)).
De ce apare: cauzele frecvente
1Tabel de constante ca Uint8Array
const PRAGURI = Object.freeze(new Uint8Array([10, 50, 90]));const PRAGURI = Object.freeze([10, 50, 90]);Un tablou obișnuit poate fi înghețat complet. Pentru câteva constante nu ai nevoie de tablou tipizat.
2Înghețare adâncă care atinge date binare
function ingheata(o) {
Object.values(o).forEach((v) => typeof v === "object" && ingheata(v));
return Object.freeze(o);
}function ingheata(o) {
for (const v of Object.values(o)) {
if (typeof v === "object" && v !== null && !ArrayBuffer.isView(v)) ingheata(v);
}
return Object.freeze(o);
}ArrayBuffer.isView recunoaște tablourile tipizate și DataView, ca funcția să le sară.
3Protecție prin copiere la citire
const imagine = Object.freeze(pixeli);const pixeliOriginali = pixeli.slice();
const citestePixeli = () => pixeliOriginali.slice();Fiecare citire primește o copie, deci originalul nu poate fi modificat din afară.
Repară eroarea, direct în pagină
Funcția ingheataAdanc protejează configurația aplicației, dar configurația conține și un Uint8Array cu o paletă de culori, iar Object.freeze aruncă TypeError: Cannot freeze array buffer views with elements. Repară funcția ca tablourile tipizate să fie sărite, iar restul configurației să fie înghețat.
function ingheataAdanc(obiect) {
for (const valoare of Object.values(obiect)) {
if (typeof valoare === "object" && valoare !== null) {
ingheataAdanc(valoare);
}
}
return Object.freeze(obiect);
}
const config = ingheataAdanc({
tema: { nume: "dark" },
paleta: new Uint8Array([20, 30, 40]),
});
console.log(`Tema înghețată: ${Object.isFrozen(config.tema)}`);
console.log(`Paleta: ${config.paleta.join(", ")}`);Tema înghețată: true Paleta: 20, 30, 40
Indiciu
ArrayBuffer.isView(valoare) e adevărat pentru tablourile tipizate.
Reparația
function ingheataAdanc(obiect) {
for (const valoare of Object.values(obiect)) {
if (typeof valoare === "object" && valoare !== null && !ArrayBuffer.isView(valoare)) {
ingheataAdanc(valoare);
}
}
return Object.freeze(obiect);
}
const config = ingheataAdanc({
tema: { nume: "dark" },
paleta: new Uint8Array([20, 30, 40]),
});
console.log(`Tema înghețată: ${Object.isFrozen(config.tema)}`);
console.log(`Paleta: ${config.paleta.join(", ")}`);De ce merge
Elementele unui tablou tipizat stau într-un ArrayBuffer care poate fi modificat și prin alte ferestre, deci motorul nu poate îngheța un Uint8Array cu elemente. ArrayBuffer.isView recunoaște tablourile tipizate și DataView, iar funcția nu mai coboară în ele. Restul obiectelor, inclusiv tema și configurația însăși, sunt înghețate ca înainte.
Alte forme ale mesajului
TypeError: Cannot seal array buffer views with elementsTypeError: can't freeze array buffer views with elementsTypeError: Cannot freeze array buffer views with elements at Function.freeze
Cum o eviți pe viitor
- Folosește tablouri tipizate pentru date binare mari, nu pentru constante.
- În funcțiile de înghețare adâncă, sari peste valorile pentru care
ArrayBuffer.isView(v)e adevărat. - Protejează datele binare prin încapsulare (câmp privat, copie la citire), nu prin
freeze. - Documentează ce funcții primesc voie să modifice bufferul.
Întrebări frecvente
De ce tabloul tipizat gol poate fi înghețat?
Fără elemente nu există memorie care să poată fi modificată prin buffer, deci motorul poate face înghețarea.
Există o variantă nemodificabilă de ArrayBuffer?
Există o propunere în standard pentru bufferi imutabili, dar nu e disponibilă peste tot. Până atunci, folosește încapsularea și copiile.
Erori înrudite
TypeError: Cannot add property reducere, object is not extensible Încerci să adaugi o proprietate nouă unui obiect blocat cu `Object.freeze`, `Object.seal` sau `Object.preventExtensions`. Obiectul nu mai acceptă chei noi. Creează o copie care include proprietatea: `{ ...obiect, reducere: 10 }`. TypeError: Cannot assign to read only property 'pret' of object '#<Object>' Încerci să modifici o proprietate care nu poate fi modificată: obiectul a fost înghețat cu `Object.freeze`, proprietatea e definită ca `writable: false` sau e o proprietate încorporată protejată. În strict mode asta aruncă eroare. Creează o copie modificată: `{ ...obiect, pret: 50 }`. TypeError: Cannot perform %TypedArray%.prototype.fill on a detached ArrayBuffer Folosești un ArrayBuffer (sau un tablou tipizat peste el) după ce l-ai transferat: cu postMessage(date, [buffer]) către un Worker, cu structuredClone(..., { transfer }) sau cu buffer.transfer(). După transfer, bufferul local e gol (detached). Transferă o copie (buffer.slice(0)) sau nu mai folosi bufferul după trimitere. Î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.
