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

RangeError: ArrayBuffer.prototype.resize: Invalid length parameter

Pe scurt

Ai cerut unui ArrayBuffer redimensionabil o mărime mai mare decât maxByteLength (sau negativă), de obicei prin dublare repetată. Limitează mărimea: buf.resize(Math.min(buf.byteLength * 2, buf.maxByteLength)) și verifică dacă datele încap.

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

Ce înseamnă

Un ArrayBuffer poate fi creat redimensionabil: new ArrayBuffer(4, { maxByteLength: 12 }). Apoi buf.resize(n) îl mărește sau micșorează, iar tablourile tipizate create fără lungime fixă (new Uint8Array(buf)) cresc odată cu el. Limita e maxByteLength, stabilită la creare: orice resize peste ea, sau cu o valoare negativă, aruncă ArrayBuffer.prototype.resize: Invalid length parameter.

Cauza clasică e strategia de creștere prin dublare (4, 8, 16...) fără să ții cont de maxim. Alte cauze: un calcul greșit al mărimii (NaN, negativ) sau o limită maximă prea mică pentru datele reale.

Două erori înrudite: dacă la creare byteLength e mai mare decât maxByteLength, primești Invalid array buffer max length, iar dacă apelezi resize pe un buffer creat fără maxByteLength, primești Method ArrayBuffer.prototype.resize called on incompatible receiver.

De ce apare: cauzele frecvente

1Dublare peste limita maximă

Greșit
JavaScript
while (i >= buf.byteLength) buf.resize(buf.byteLength * 2);
Corect
JavaScript
while (i >= buf.byteLength) {
  if (buf.byteLength === buf.maxByteLength) throw new Error("Buffer plin");
  buf.resize(Math.min(buf.byteLength * 2, buf.maxByteLength));
}

Mărimea nouă nu depășește maximul, iar cazul „plin” e tratat explicit.

2Maxim prea mic pentru date

Greșit
JavaScript
const buf = new ArrayBuffer(1024, { maxByteLength: 2048 });
buf.resize(fisier.size);
Corect
JavaScript
const buf = new ArrayBuffer(1024, { maxByteLength: 16 * 1024 * 1024 });
buf.resize(fisier.size);

Maximul trebuie ales după cele mai mari date pe care le accepți (și verificat la intrare).

3Mărime negativă din calcul

Greșit
JavaScript
buf.resize(buf.byteLength - eliberat); // eliberat prea mare
Corect
JavaScript
buf.resize(Math.max(0, buf.byteLength - eliberat));

Lungimea nu poate fi negativă; Math.max o oprește la zero.

Repară tu

Repară eroarea, direct în pagină

Funcția scrie mărește bufferul prin dublare când indexul nu mai încape, dar dublarea trece peste maxByteLength și dă RangeError: ArrayBuffer.prototype.resize: Invalid length parameter. Repară creșterea (fără să schimbi limita de 12 octeți) ca programul să afișeze Octeți: 12, ultimul: 9.

Codul care dă eroarea
JavaScript
const buf = new ArrayBuffer(4, { maxByteLength: 12 });
const octeti = new Uint8Array(buf);

function scrie(i, valoare) {
  while (i >= buf.byteLength) {
    buf.resize(buf.byteLength * 2);
  }
  octeti[i] = valoare;
}

for (let i = 0; i < 10; i++) scrie(i, i);
console.log(`Octeți: ${buf.byteLength}, ultimul: ${octeti[9]}`);
După reparație, programul afișează
Octeți: 12, ultimul: 9
Indiciu

Folosește Math.min(buf.byteLength * 2, buf.maxByteLength) ca mărime nouă.

Alte forme ale mesajului

  • RangeError: Invalid array buffer max length
  • RangeError: invalid array buffer length
  • RangeError: ArrayBuffer.prototype.resize: Invalid length parameter at ArrayBuffer.resize

Cum o eviți pe viitor

  • Când creezi un buffer redimensionabil, alege maxByteLength după limita reală a aplicației.
  • Calculează mereu mărimea nouă cu Math.min(..., buf.maxByteLength).
  • Verifică buf.resizable înainte de resize dacă bufferul vine din altă parte.
  • Pentru date de mărime necunoscută, un tablou de bucăți (chunks) e adesea mai simplu decât un singur buffer care crește.

Întrebări frecvente

De ce nu crește bufferul automat?

Memoria pentru maxByteLength e rezervată la creare, ca bufferul să poată crește fără copiere. Dincolo de ea nu există spațiu rezervat.

În ce medii există resize?

În browserele moderne și în Node 20 sau mai nou. În medii vechi, resize nu există și trebuie să copiezi datele într-un buffer nou.

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.