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

TypeError: Cannot perform %TypedArray%.prototype.fill on a detached ArrayBuffer

Pe scurt

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.

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

Ce înseamnă

Transferul unui ArrayBuffer (în lista transfer a lui postMessage sau structuredClone, ori cu buffer.transfer()) mută memoria către destinație fără copiere, ceea ce e foarte rapid pentru date mari. Prețul: bufferul original devine detached, adică byteLength 0 și nicio operație permisă. Orice metodă care îl atinge aruncă Cannot perform <operație> on a detached ArrayBuffer: %TypedArray%.prototype.fill, DataView.prototype.getUint8, Construct (crearea unui tablou nou peste el) și așa mai departe.

Capcana e că indexarea simplă (tablou[0]) nu aruncă eroare, ci întoarce undefined, iar length devine 0. De aceea unele bucle par să meargă, dar nu fac nimic, iar eroarea apare abia la prima metodă.

Caută în cod unde trimiți bufferul cu transfer și ce face codul după aceea. Dacă mai ai nevoie de date local, transferă o copie (buffer.slice(0)) sau trimite fără listă de transfer (datele se copiază automat). Dacă nu, creează un buffer nou pentru lucrul următor.

De ce apare: cauzele frecvente

1Buffer refolosit după postMessage cu transfer

Greșit
JavaScript
worker.postMessage(cadru.buffer, [cadru.buffer]);
cadru.fill(0);
Corect
JavaScript
worker.postMessage(cadru.buffer, [cadru.buffer]);
cadru = new Uint8Array(DIMENSIUNE);

Bufferul trimis aparține acum workerului. Pentru cadrul următor creezi unul nou.

2Ai nevoie de date și local

Greșit
JavaScript
worker.postMessage(date.buffer, [date.buffer]);
console.log(date[0]);
Corect
JavaScript
const copie = date.buffer.slice(0);
worker.postMessage(copie, [copie]);
console.log(date[0]);

Transferi o copie, iar originalul rămâne utilizabil.

3Transfer cu structuredClone

Greșit
JavaScript
const mutat = structuredClone(buf, { transfer: [buf] });
new Uint8Array(buf);
Corect
JavaScript
const mutat = structuredClone(buf, { transfer: [buf] });
new Uint8Array(mutat);

După transfer, lucrezi cu rezultatul, nu cu bufferul vechi. Altfel primești Cannot perform Construct on a detached ArrayBuffer.

Repară tu

Repară eroarea, direct în pagină

Funcția trimite mută bufferul unui cadru către destinație cu structuredClone(..., { transfer }), la fel ca postMessage către un Worker, apoi codul golește cadrul local cu fill(0) și primește TypeError: Cannot perform %TypedArray%.prototype.fill on a detached ArrayBuffer. Repară codul ca după trimitere să se lucreze cu un cadru nou.

Codul care dă eroarea
JavaScript
function trimite(cadru) {
  return structuredClone(cadru.buffer, { transfer: [cadru.buffer] });
}

let cadru = new Uint8Array([10, 20, 30, 40]);
const primit = new Uint8Array(trimite(cadru));
cadru.fill(0);

console.log(`Primit: ${primit.join(" ")}`);
console.log(`Cadru nou: ${cadru.length} octeți`);
După reparație, programul afișează
Primit: 10 20 30 40
Cadru nou: 4 octeți
Indiciu

După transfer, bufferul vechi e gol: creează un Uint8Array nou pentru cadrul următor.

Alte forme ale mesajului

  • TypeError: Cannot perform Construct on a detached ArrayBuffer
  • TypeError: Cannot perform DataView.prototype.getUint8 on a detached ArrayBuffer
  • TypeError: attempting to access detached ArrayBuffer
  • TypeError: Cannot perform %TypedArray%.prototype.set on a detached ArrayBuffer

Cum o eviți pe viitor

  • Tratează transferul ca pe o mutare: după postMessage(x, [x]) nu mai folosi x.
  • Transferă doar bufferele de care nu mai ai nevoie local; pentru restul, lasă copierea automată.
  • Verifică buffer.detached (sau byteLength === 0) când nu ești sigur.
  • Pune trimiterea cu transfer într-o funcție care întoarce un buffer nou pentru lucrul următor.

Întrebări frecvente

De ce tablou[0] nu dă eroare, dar tablou.fill() da?

Accesul prin index pe un tablou tipizat detașat întoarce undefined, ca la orice index din afara tabloului. Metodele verifică explicit starea bufferului și aruncă TypeError.

Merită transferul, dacă pot copia?

Pentru bufferi mari, de exemplu imagini, audio sau fișiere, da: transferul e instant, copierea durează. Pentru date mici, copierea automată e mai simplă și mai sigură.

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.