...
Eroare JavaScript · Date binare: ArrayBuffer, TypedArray și DataView

TypeError: Cannot freeze array buffer views with elements

Pe scurt

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

Greșit
JavaScript
const PRAGURI = Object.freeze(new Uint8Array([10, 50, 90]));
Corect
JavaScript
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

Greșit
JavaScript
function ingheata(o) {
  Object.values(o).forEach((v) => typeof v === "object" && ingheata(v));
  return Object.freeze(o);
}
Corect
JavaScript
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

Greșit
JavaScript
const imagine = Object.freeze(pixeli);
Corect
JavaScript
const pixeliOriginali = pixeli.slice();
const citestePixeli = () => pixeliOriginali.slice();

Fiecare citire primește o copie, deci originalul nu poate fi modificat din afară.

Repară tu

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.

Codul care dă eroarea
JavaScript
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(", ")}`);
După reparație, programul afișează
Tema înghețată: true
Paleta: 20, 30, 40
Indiciu

ArrayBuffer.isView(valoare) e adevărat pentru tablourile tipizate.

Alte forme ale mesajului

  • TypeError: Cannot seal array buffer views with elements
  • TypeError: can't freeze array buffer views with elements
  • TypeError: 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

← 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.