TypeError: First argument to DataView constructor must be an ArrayBuffer
Ai dat lui new DataView un Uint8Array (sau alt tablou tipizat, ori un tablou obișnuit) în loc de ArrayBuffer. Dă-i bufferul din spatele lui, cu deplasamentul corect: new DataView(octeti.buffer, octeti.byteOffset, octeti.byteLength).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
DataView citește și scrie numere de diferite mărimi (getUint16, getFloat32...) direct dintr-o zonă de memorie. Zona aceea e un ArrayBuffer (sau SharedArrayBuffer). Un Uint8Array nu e un buffer, ci o „fereastră” peste unul, așa că new DataView(octeti) aruncă First argument to DataView constructor must be an ArrayBuffer. La fel pentru un tablou obișnuit [1, 2, 3].
Apare des când primești date binare de la fetch (await r.bytes()), din TextEncoder, de la un fișier citit (file.arrayBuffer() dă buffer, dar biblioteci dau Uint8Array) sau de la Node (Buffer e tot un Uint8Array).
Atenție la reparație: octeti.buffer poate fi mai mare decât fereastra (de exemplu un subarray sau un Buffer din Node, care folosește un buffer comun). Dă mereu și byteOffset și byteLength, ca să citești exact octeții tăi.
De ce apare: cauzele frecvente
1Uint8Array dat direct lui DataView
const octeti = new Uint8Array([0x01, 0x02]);
const vedere = new DataView(octeti);const octeti = new Uint8Array([0x01, 0x02]);
const vedere = new DataView(octeti.buffer, octeti.byteOffset, octeti.byteLength);DataView lucrează pe buffer; deplasamentul și lungimea păstrează aceeași fereastră ca a tabloului tipizat.
2Tablou obișnuit de numere
const vedere = new DataView([0, 10, 0, 20]);const vedere = new DataView(new Uint8Array([0, 10, 0, 20]).buffer);Un tablou JavaScript nu are memorie binară. Îl transformi întâi în Uint8Array, care are buffer.
3Fereastră dintr-un buffer mai mare
const parte = date.subarray(4, 8);
new DataView(parte.buffer).getUint32(0);const parte = date.subarray(4, 8);
new DataView(parte.buffer, parte.byteOffset, 4).getUint32(0);Fără byteOffset, ai citi primii octeți ai bufferului întreg, nu ai ferestrei.
Repară eroarea, direct în pagină
Antetul unui fișier binar vine ca Uint8Array, iar codul vrea să citească lățimea și înălțimea (câte 2 octeți) cu DataView, dar dă TypeError: First argument to DataView constructor must be an ArrayBuffer. Repară crearea DataView ca programul să afișeze Imagine 640x480.
const octeti = new Uint8Array([0x02, 0x80, 0x01, 0xe0]);
const vedere = new DataView(octeti);
const latime = vedere.getUint16(0);
const inaltime = vedere.getUint16(2);
console.log(`Imagine ${latime}x${inaltime}`);Imagine 640x480
Indiciu
Dă lui DataView octeti.buffer, octeti.byteOffset și octeti.byteLength.
Reparația
const octeti = new Uint8Array([0x02, 0x80, 0x01, 0xe0]);
const vedere = new DataView(octeti.buffer, octeti.byteOffset, octeti.byteLength);
const latime = vedere.getUint16(0);
const inaltime = vedere.getUint16(2);
console.log(`Imagine ${latime}x${inaltime}`);De ce merge
DataView se construiește peste memoria brută, un ArrayBuffer, nu peste o fereastră ca Uint8Array. octeti.buffer e memoria din spate, iar byteOffset și byteLength limitează vederea la exact cei 4 octeți. getUint16 citește apoi câte doi octeți în ordinea big endian: 0x0280 = 640 și 0x01e0 = 480.
Alte forme ale mesajului
TypeError: DataView: expected ArrayBuffer or SharedArrayBufferTypeError: First argument to DataView constructor must be an ArrayBuffer at new DataViewTypeError: DataView constructor: argument 1 is not an ArrayBuffer
Cum o eviți pe viitor
- Reține ierarhia:
ArrayBuffere memoria,Uint8Array/DataViewsunt ferestre peste ea. - Scrie o funcție ajutătoare
vedereDin(octeti)care face mereunew DataView(o.buffer, o.byteOffset, o.byteLength). - Verifică tipul cu
ArrayBuffer.isView(x)(fereastră) saux instanceof ArrayBuffer(memorie). - Pentru citiri simple de octeți, uneori un
Uint8Arraye suficient și nu ai nevoie deDataView.
Întrebări frecvente
De ce am nevoie de DataView, dacă am deja Uint8Array?
Uint8Array citește doar octeți unul câte unul. DataView citește numere pe 2, 4 sau 8 octeți și îți lasă să alegi ordinea octeților (little sau big endian).
Buffer din Node merge cu DataView?
Da, dar prin buf.buffer, buf.byteOffset, buf.byteLength. Bufferele mici din Node împart des aceeași memorie, deci deplasamentul e esențial.
Erori înrudite
RangeError: Offset is outside the bounds of the DataView Ai citit sau scris într-un DataView la o poziție la care nu mai încap toți octeții ceruți: de exemplu getUint32(6) pe un buffer de 8 octeți (ar trebui octeții 6–9). Verifică offset + dimensiune <= byteLength, mai ales în buclele care parcurg datele. 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. TypeError: this is not a typed array. O metodă de tablou tipizat (fill, set, subarray, map) a fost apelată fără tabloul ei ca this, de obicei pentru că ai salvat metoda într-o variabilă sau într-un obiect (const umple = pixeli.fill). Apeleaz-o pe tablou: pixeli.fill(0), sau învelește-o într-o arrow function. Î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.
