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.
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
worker.postMessage(cadru.buffer, [cadru.buffer]);
cadru.fill(0);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
worker.postMessage(date.buffer, [date.buffer]);
console.log(date[0]);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
const mutat = structuredClone(buf, { transfer: [buf] });
new Uint8Array(buf);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ă 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.
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`);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.
Reparația
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 = new Uint8Array(4);
console.log(`Primit: ${primit.join(" ")}`);
console.log(`Cadru nou: ${cadru.length} octeți`);De ce merge
Transferul mută memoria bufferului către destinație fără copiere, iar bufferul local devine detașat: lungime 0 și nicio operație permisă, de aceea fill arunca eroarea. Datele sunt acum în primit. Pentru lucrul următor creăm un Uint8Array nou, cu buffer propriu, care pornește deja plin de zerouri, deci fill(0) nici nu mai e necesar.
Alte forme ale mesajului
TypeError: Cannot perform Construct on a detached ArrayBufferTypeError: Cannot perform DataView.prototype.getUint8 on a detached ArrayBufferTypeError: attempting to access detached ArrayBufferTypeError: 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 folosix. - Transferă doar bufferele de care nu mai ai nevoie local; pentru restul, lasă copierea automată.
- Verifică
buffer.detached(saubyteLength === 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
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ă. RangeError: offset is out of bounds Metoda set a unui tablou tipizat (tinta.set(sursa, offset)) a primit date care nu încap: offset + sursa.length e mai mare decât tinta.length. Apare des când lipești mai multe bucăți într-un buffer prea mic. Calculează întâi lungimea totală și creează ținta cu dimensiunea corectă. RangeError: Start offset 8 is outside the bounds of the buffer Ai creat un tablou tipizat sau un DataView peste un ArrayBuffer pornind de la un offset mai mare decât bufferul: de exemplu offset 8 pe un buffer de 4 octeți. De obicei datele sunt mai scurte decât antetul presupus. Verifică buffer.byteLength înainte să creezi fereastra. Î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.
