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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Lungimea unui tablou trebuie să fie un număr întreg între 0 și 2³² − 1. Orice altceva aruncă RangeError: Invalid array length.
Eroarea apare la new Array(n) sau Array(n) cu n negativ (new Array(-1)), cu zecimale (new Array(2.5)) sau uriaș; la atribuirea directă lista.length = -1; și la Array.from({ length: n }) cu n greșit. Mai poate apărea într-o buclă infinită care adaugă elemente într-un tablou până la limită.
De obicei n vine dintr-un calcul: o diferență care iese negativă (final - start când datele sunt inversate), o împărțire fără rotunjire (total / 2 cu total impar) sau o valoare citită ca text. Afișează valoarea chiar înainte de linia raportată.
De ce apare: cauzele frecvente
1Lungime negativă dintr-o diferență
const start = 10, final = 7;
const zile = new Array(final - start);const start = 10, final = 7;
const zile = new Array(Math.max(0, final - start));Diferența e -3. Math.max(0, ...) sau o verificare clară evită lungimile negative.
2Lungime cu zecimale
const elevi = 7;
const grupe = new Array(elevi / 2);const elevi = 7;
const grupe = new Array(Math.ceil(elevi / 2));7 / 2 = 3.5 nu e o lungime validă. Rotunjește cu Math.ceil sau Math.floor, după caz.
3Lungime setată direct
const lista = [1, 2, 3];
lista.length = lista.length - 5;const lista = [1, 2, 3];
lista.length = Math.max(0, lista.length - 5);
// sau lista.splice(...)length nu poate fi negativă. Pentru eliminare de elemente, slice și splice sunt mai clare.
Repară eroarea, direct în pagină
Programul de mai jos împarte 7 elevi în echipe de câte 2 și pregătește câte un loc pentru fiecare echipă, dar se oprește cu RangeError: Invalid array length. Repară calculul numărului de echipe ca programul să afișeze Echipe: 4 și Echipa 1, Echipa 2, Echipa 3, Echipa 4.
const elevi = 7;
const marimeEchipa = 2;
const echipe = Array.from(new Array(elevi / marimeEchipa), (_, i) => `Echipa ${i + 1}`);
console.log(`Echipe: ${echipe.length}`);
console.log(echipe.join(", "));Echipe: 4 Echipa 1, Echipa 2, Echipa 3, Echipa 4
Indiciu
7 / 2 nu e un număr întreg. Ultima echipă poate avea și un singur elev, deci rotunjește în sus.
Reparația
const elevi = 7;
const marimeEchipa = 2;
const echipe = Array.from(new Array(Math.ceil(elevi / marimeEchipa)), (_, i) => `Echipa ${i + 1}`);
console.log(`Echipe: ${echipe.length}`);
console.log(echipe.join(", "));De ce merge
Lungimea unui tablou trebuie să fie un număr întreg nenegativ, iar 7 / 2 = 3.5. new Array(3.5) aruncă deci Invalid array length. Math.ceil rotunjește în sus la 4, ceea ce corespunde realității: trei echipe de câte doi și una cu un singur elev. Array.from umple apoi fiecare loc cu numele echipei.
Alte forme ale mesajului
RangeError: Invalid typed array length: -1RangeError: Invalid array buffer length
Cum o eviți pe viitor
- Când calculezi o lungime, rotunjește explicit (
Math.floor,Math.ceil) și verifică să nu fie negativă. - Preferă
Array.from({ length: n }, (_, i) => ...)cu unnvalidat, sau construiește tablouri cupushîn buclă. - Atenție la datele inversate (
final < start) și la valorile citite ca text.
Întrebări frecvente
De ce new Array(3) nu are elemente?
Creează un tablou cu lungimea 3, dar cu locuri goale. Pentru valori, folosește new Array(3).fill(0) sau Array.from({ length: 3 }, (_, i) => i).
Poate o buclă infinită să dea eroarea asta?
Da, dacă adaugă la nesfârșit într-un tablou. De obicei însă programul se blochează sau rămâne fără memorie înainte.
Erori înrudite
RangeError: Maximum call stack size exceeded O funcție se apelează pe ea însăși (direct sau prin altele) de prea multe ori, de obicei la nesfârșit: lipsește cazul de bază al recursivității, condiția de oprire nu e atinsă niciodată sau un getter/setter se apelează singur. Adaugă sau corectează condiția de oprire. RangeError: Invalid time value Ai apelat `toISOString()` (sau o formatare cu `Intl`) pe o dată invalidă, `Invalid Date`, creată dintr-un text pe care `new Date` nu l-a înțeles, de exemplu `"31.10.2026"`. Folosește formatul `"2026-10-31"` sau construiește data din numere: `new Date(2026, 9, 31)`. Î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.
