...
Eroare JavaScript · RangeError: valori în afara intervalului

RangeError: Invalid array length

Pe scurt

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ță

Greșit
JavaScript
const start = 10, final = 7;
const zile = new Array(final - start);
Corect
JavaScript
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

Greșit
JavaScript
const elevi = 7;
const grupe = new Array(elevi / 2);
Corect
JavaScript
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

Greșit
JavaScript
const lista = [1, 2, 3];
lista.length = lista.length - 5;
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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(", "));
După reparație, programul afișează
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.

Alte forme ale mesajului

  • RangeError: Invalid typed array length: -1
  • RangeError: 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 un n validat, sau construiește tablouri cu push î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

← 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.