RangeError: ArrayBuffer.prototype.resize: Invalid length parameter
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ă
while (i >= buf.byteLength) buf.resize(buf.byteLength * 2);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
const buf = new ArrayBuffer(1024, { maxByteLength: 2048 });
buf.resize(fisier.size);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
buf.resize(buf.byteLength - eliberat); // eliberat prea marebuf.resize(Math.max(0, buf.byteLength - eliberat));Lungimea nu poate fi negativă; Math.max o oprește la zero.
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.
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]}`);Octeți: 12, ultimul: 9
Indiciu
Folosește Math.min(buf.byteLength * 2, buf.maxByteLength) ca mărime nouă.
Reparația
const buf = new ArrayBuffer(4, { maxByteLength: 12 });
const octeti = new Uint8Array(buf);
function scrie(i, valoare) {
while (i >= buf.byteLength) {
buf.resize(Math.min(buf.byteLength * 2, buf.maxByteLength));
}
octeti[i] = valoare;
}
for (let i = 0; i < 10; i++) scrie(i, i);
console.log(`Octeți: ${buf.byteLength}, ultimul: ${octeti[9]}`);De ce merge
Bufferul pornește de la 4 octeți și poate crește până la 12. Dublarea dă 8, apoi ar cere 16, peste maxim, și resize aruncă eroarea. Cu Math.min, a doua creștere se oprește la 12, suficient pentru indicii 0–9. Tabloul octeti, creat fără lungime fixă, crește odată cu bufferul.
Alte forme ale mesajului
RangeError: Invalid array buffer max lengthRangeError: invalid array buffer lengthRangeError: ArrayBuffer.prototype.resize: Invalid length parameter at ArrayBuffer.resize
Cum o eviți pe viitor
- Când creezi un buffer redimensionabil, alege
maxByteLengthdupă limita reală a aplicației. - Calculează mereu mărimea nouă cu
Math.min(..., buf.maxByteLength). - Verifică
buf.resizableînainte deresizedacă 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
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. RangeError: offset is out of bounds Metoda set a unui tablou tipizat (tinta.set(sursa, offset)) a primit date care nu încap: offset + sursa.length e mai mare decât tinta.length. Apare des când lipești mai multe bucăți într-un buffer prea mic. Calculează întâi lungimea totală și creează ținta cu dimensiunea corectă. TypeError: Cannot perform %TypedArray%.prototype.fill on a detached ArrayBuffer Folosești un ArrayBuffer (sau un tablou tipizat peste el) după ce l-ai transferat: cu postMessage(date, [buffer]) către un Worker, cu structuredClone(..., { transfer }) sau cu buffer.transfer(). După transfer, bufferul local e gol (detached). Transferă o copie (buffer.slice(0)) sau nu mai folosi bufferul după trimitere. Î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.
