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

TypeError: First argument to DataView constructor must be an ArrayBuffer

Pe scurt

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

Greșit
JavaScript
const octeti = new Uint8Array([0x01, 0x02]);
const vedere = new DataView(octeti);
Corect
JavaScript
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

Greșit
JavaScript
const vedere = new DataView([0, 10, 0, 20]);
Corect
JavaScript
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

Greșit
JavaScript
const parte = date.subarray(4, 8);
new DataView(parte.buffer).getUint32(0);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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}`);
După reparație, programul afișează
Imagine 640x480
Indiciu

Dă lui DataView octeti.buffer, octeti.byteOffset și octeti.byteLength.

Alte forme ale mesajului

  • TypeError: DataView: expected ArrayBuffer or SharedArrayBuffer
  • TypeError: First argument to DataView constructor must be an ArrayBuffer at new DataView
  • TypeError: DataView constructor: argument 1 is not an ArrayBuffer

Cum o eviți pe viitor

  • Reține ierarhia: ArrayBuffer e memoria, Uint8Array/DataView sunt ferestre peste ea.
  • Scrie o funcție ajutătoare vedereDin(octeti) care face mereu new DataView(o.buffer, o.byteOffset, o.byteLength).
  • Verifică tipul cu ArrayBuffer.isView(x) (fereastră) sau x instanceof ArrayBuffer (memorie).
  • Pentru citiri simple de octeți, uneori un Uint8Array e suficient și nu ai nevoie de DataView.

Î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

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