RangeError: Invalid string length
Ai încercat să construiești un text mai lung decât limita motorului (în Chrome și Node, aproximativ 512 milioane de caractere): cu repeat, padEnd, join, JSON.stringify pe date uriașe sau o concatenare într-o buclă care nu se mai oprește. Verifică dimensiunea calculată și bucla.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un șir de caractere în JavaScript are o lungime maximă stabilită de motor. În V8 (Chrome, Edge, Node) limita e în jur de 2^29 caractere, adică aproximativ 536 de milioane; în alte motoare e alta. Orice operație care ar produce un text mai lung aruncă RangeError: Invalid string length.
Cauzele reale sunt aproape mereu greșeli, nu nevoia unui text uriaș:
- o dimensiune calculată greșit:
"x".repeat(1024 3)(1 GB) când voiai 1 MB (1024 2); - o buclă infinită care adaugă la un text, mai ales una care îl dublează (
s += s); JSON.stringifysaujoinpe o colecție mult mai mare decât credeai;- citirea unui fișier mare cu totul în memorie, ca text.
Stiva arată funcția (String.repeat, JSON.stringify, Array.join) unde s-a depășit limita. Afișează lungimea sau numărul de elemente chiar înainte ca să vezi de unde vine valoarea mare.
De ce apare: cauzele frecvente
1Unitate greșită în calcul
const marime = 1024 ** 3; // 1 GB
const test = "x".repeat(marime);const marime = 1024 ** 2; // 1 MB
const test = "x".repeat(marime);Un miliard de caractere depășește limita; un milion e în regulă.
2Buclă care nu se oprește
let raport = "Raport\n";
let i = 0;
while (i < linii.length) {
raport += raport;
}let raport = "Raport\n";
for (const linie of linii) {
raport += linie + "\n";
}Bucla inițială nu crește i și dublează textul la fiecare pas.
3Date prea mari pentru un singur text
const json = JSON.stringify(toateInregistrarile);for (const lot of loturi) {
trimite(JSON.stringify(lot));
}Împarte datele în loturi sau folosește streaming în loc de un text gigant.
Repară eroarea, direct în pagină
Programul trebuie să genereze un text de test de 1 MB (1024 * 1024 caractere), dar se oprește cu RangeError: Invalid string length. Repară calculul dimensiunii ca programul să afișeze Lungime: 1048576.
const MB = 1024 ** 3;
const text = "x".repeat(MB);
console.log(`Lungime: ${text.length}`);Lungime: 1048576
Indiciu
1 MB înseamnă 1024 la puterea a doua, nu a treia.
Reparația
const MB = 1024 ** 2;
const text = "x".repeat(MB);
console.log(`Lungime: ${text.length}`);De ce merge
1024 ** 3 înseamnă aproximativ un miliard de caractere (1 GB), peste lungimea maximă a unui șir în V8, așa că repeat a aruncat RangeError. Un megabyte are 1024 * 1024 = 1048576 de caractere de un byte, adică 1024 ** 2. Un text de această mărime se creează instant și încape fără probleme în memorie.
Alte forme ale mesajului
InternalError: allocation size overflowRangeError: repeat count must be less than infinity and not overflow maximum string size
Cum o eviți pe viitor
- Verifică unitățile când calculezi dimensiuni (KB = 1024, MB = 1024 ** 2).
- Pune o limită de siguranță în buclele care construiesc text.
- Pentru volume mari, scrie pe bucăți (stream-uri, loturi), nu într-un singur șir.
- Construiește rapoarte lungi într-un tablou și unește-l cu
joinla final, după ce știi câte linii ai.
Întrebări frecvente
Care e exact lungimea maximă?
Depinde de motor și de versiune. În V8 pe 64 de biți e puțin sub 2^29 caractere; în Firefox e alta. Nu te baza pe valoare: dacă ești aproape de ea, ai nevoie de altă abordare.
De ce uneori primesc „heap out of memory” în loc de această eroare?
Dacă textul nu depășește limita de lungime, dar memoria disponibilă se termină înainte, procesul se oprește cu o eroare de memorie. Ambele indică un text sau o structură prea mare.
Erori înrudite
RangeError: Invalid count value: -1 Metoda `repeat` a primit un număr negativ sau `Infinity`: `"*".repeat(-1)`. Numărul de repetări trebuie să fie între 0 și o limită finită. Verifică calculul (de multe ori o diferență care iese negativă) și folosește `Math.max(0, n)`. 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: 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. Î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.
