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

RangeError: start offset of Float32Array should be a multiple of 4

Pe scurt

Ai creat un tablou tipizat (Float32Array, Int32Array, Float64Array...) peste un ArrayBuffer, pornind de la un offset care nu e multiplu de dimensiunea elementului: de exemplu Float32Array la octetul 2. Copiază porțiunea cu buffer.slice(offset) sau citește valorile cu DataView, care acceptă orice offset.

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

Ce înseamnă

Tablourile tipizate pot fi „ferestre” peste un ArrayBuffer existent: new Int32Array(buffer, offset, lungime). Pentru că elementele lor au 2, 4 sau 8 octeți, specificația cere ca offsetul de start să fie multiplu de dimensiunea elementului (aliniere): 4 pentru Int32Array și Float32Array, 8 pentru Float64Array și BigInt64Array, 2 pentru Int16Array. Altfel: start offset of Float32Array should be a multiple of 4. Varianta byte length of Int32Array should be a multiple of 4 apare când bufferul rămas nu se împarte exact în elemente.

Problema apare la formatele binare cu antet de dimensiune „ciudată”: un octet de tip și un octet de versiune, urmate de numere Float32. Datele sunt corecte, dar nu sunt aliniate.

Ai două soluții: copiezi porțiunea într-un buffer nou (buffer.slice(2)), care începe de la 0 și e aliniat, sau citești valorile una câte una cu DataView, care nu are cerințe de aliniere și îți permite și să alegi ordinea octeților.

De ce apare: cauzele frecvente

1Fereastră Float32 după un antet de 2 octeți

Greșit
JavaScript
const valori = new Float32Array(buffer, 2);
Corect
JavaScript
const valori = new Float32Array(buffer.slice(2));

slice copiază octeții într-un buffer nou, care începe la 0 și e deci aliniat.

2Citire fără copiere, cu DataView

Greșit
JavaScript
const valori = new Int32Array(buffer, 1, 3);
Corect
JavaScript
const view = new DataView(buffer);
const valori = [0, 1, 2].map((i) => view.getInt32(1 + i * 4, true));

DataView citește de la orice offset. E soluția bună când nu vrei să copiezi date mari.

3Lungime care nu se împarte exact

Greșit
JavaScript
const v = new Int32Array(new ArrayBuffer(10));
Corect
JavaScript
const v = new Int32Array(new ArrayBuffer(12));

Un buffer de 10 octeți nu conține un număr întreg de valori pe 4 octeți. Mesajul e byte length of Int32Array should be a multiple of 4.

Repară tu

Repară eroarea, direct în pagină

Un mesaj binar are un antet de 2 octeți, urmat de valori Float32. Funcția citesteValori creează un Float32Array direct de la octetul 2 și primește RangeError: start offset of Float32Array should be a multiple of 4. Repară funcția ca programul să afișeze cele două valori.

Codul care dă eroarea
JavaScript
function citesteValori(buffer) {
  const valori = new Float32Array(buffer, 2);
  return Array.from(valori);
}

const mesaj = new Uint8Array(10);
mesaj.set([1, 7]);
mesaj.set(new Uint8Array(new Float32Array([1.5, 2.25]).buffer), 2);

console.log(`Valori: ${citesteValori(mesaj.buffer).join(", ")}`);
După reparație, programul afișează
Valori: 1.5, 2.25
Indiciu

Copiază porțiunea de după antet într-un buffer nou, care începe aliniat.

Alte forme ale mesajului

  • RangeError: start offset of Int32Array should be a multiple of 4
  • RangeError: byte length of Int32Array should be a multiple of 4
  • RangeError: start offset of Float64Array should be a multiple of 8

Cum o eviți pe viitor

  • Când proiectezi un format binar, aliniază câmpurile numerice (completează antetul până la un multiplu de 4 sau 8).
  • Pentru formate pe care nu le controlezi, citește cu DataView.
  • Calculează lungimile ca octeti / Tablou.BYTES_PER_ELEMENT și verifică restul împărțirii.
  • Ține minte ordinea octeților: DataView folosește implicit big-endian, tablourile tipizate pe cea a procesorului.

Întrebări frecvente

De ce Uint8Array nu are această problemă?

Elementele lui au un singur octet, deci orice offset e multiplu de 1. Cerința de aliniere apare doar la elementele de 2, 4 sau 8 octeți.

slice copiază datele?

Da, ArrayBuffer.prototype.slice creează o copie. Pentru date foarte mari, DataView evită copierea.

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.