RangeError: start offset of Float32Array should be a multiple of 4
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
const valori = new Float32Array(buffer, 2);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
const valori = new Int32Array(buffer, 1, 3);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
const v = new Int32Array(new ArrayBuffer(10));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ă 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.
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(", ")}`);Valori: 1.5, 2.25
Indiciu
Copiază porțiunea de după antet într-un buffer nou, care începe aliniat.
Reparația
function citesteValori(buffer) {
const valori = new Float32Array(buffer.slice(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(", ")}`);De ce merge
Float32Array cere ca fereastra să înceapă la un multiplu de 4 octeți, iar antetul de 2 octeți împinge valorile la poziția 2. buffer.slice(2) copiază cei 8 octeți de după antet într-un ArrayBuffer nou, care începe de la 0, deci e aliniat. Tabloul creat peste el conține exact cele două valori scrise în mesaj.
Alte forme ale mesajului
RangeError: start offset of Int32Array should be a multiple of 4RangeError: byte length of Int32Array should be a multiple of 4RangeError: 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:
DataViewfoloseș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
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. RangeError: Invalid array length Ai cerut un tablou cu o lungime imposibilă: negativă, cu zecimale, `NaN` sau mai mare decât limita de aproximativ 4,29 miliarde. Cel mai des, `new Array(n)` primește un `n` calculat greșit. Verifică valoarea lui `n` înainte să creezi tabloul. Î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.
