RangeError: Maximum BigInt size exceeded
Rezultatul unei operații cu BigInt ar avea mai mulți biți decât permite motorul (aproximativ un miliard). Aproape mereu e o putere cu exponent uriaș, ca 2n ** 10000000000n. Verifică exponentul; dacă îți trebuie doar mărimea rezultatului (numărul de cifre), calculează-l cu logaritmi.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
BigInt poate reprezenta numere întregi oricât de mari, dar „oricât” are o limită practică: motorul V8 (Chrome, Node) refuză numerele mai mari de aproximativ 2 la puterea un miliard. Când rezultatul unei operații ar depăși limita, primești Maximum BigInt size exceeded. În Firefox mesajul este BigInt is too large to allocate.
În practică eroarea apare la ridicări la putere (**) sau la deplasări pe biți (<<) cu un exponent mult prea mare. Exponentul vine de obicei dintr-o greșeală de unități (milisecunde în loc de secunde, biți în loc de octeți), dintr-o buclă care crește necontrolat sau dintr-un calcul pe care l-ai vrut aproximativ, dar l-ai scris exact.
Întreabă-te întâi dacă ai nevoie de valoarea exactă. Un număr cu miliarde de cifre nu poate fi afișat sau folosit. Dacă vrei doar câte cifre are, sau o comparație, logaritmii (n * Math.log10(2)) dau răspunsul instant.
De ce apare: cauzele frecvente
1Exponent în unități greșite
const ms = 1_700_000_000_000;
const rezultat = 2n ** BigInt(ms);const secunde = 1_700_000_000_000 / 1000;
console.log(`Cifre: ${Math.floor(secunde * Math.log10(2)) + 1}`);Exponentul era în milisecunde. Pentru un număr atât de mare, calculezi doar mărimea, cu logaritmi.
2Valoare exactă cerută doar pentru numărul de cifre
const cifre = (2n ** 10_000_000_000n).toString().length;const cifre = Math.floor(10_000_000_000 * Math.log10(2)) + 1;Numărul de cifre al lui 2^n este partea întreagă din n·log10(2), plus 1.
3Deplasare pe biți cu o valoare greșită
const masca = 1n << BigInt(bitiTotal * 1024 ** 3);const masca = 1n << BigInt(bitiTotal);Deplasarea << e tot o înmulțire cu o putere a lui 2. Verifică unitatea valorii.
Repară eroarea, direct în pagină
Funcția cifrePutere2 află câte cifre are 2 la puterea n calculând numărul exact cu BigInt. Pentru n = 10000000000, programul aruncă RangeError: Maximum BigInt size exceeded. Rescrie funcția cu logaritmi, fără BigInt, ca programul să afișeze numărul de cifre pentru ambele valori.
function cifrePutere2(n) {
return (2n ** BigInt(n)).toString().length;
}
console.log(`2^64 are ${cifrePutere2(64)} cifre`);
console.log(`2^10000000000 are ${cifrePutere2(10_000_000_000)} cifre`);2^64 are 20 cifre 2^10000000000 are 3010299957 cifre
Indiciu
Numărul de cifre al lui 2^n este Math.floor(n * Math.log10(2)) + 1.
Reparația
function cifrePutere2(n) {
return Math.floor(n * Math.log10(2)) + 1;
}
console.log(`2^64 are ${cifrePutere2(64)} cifre`);
console.log(`2^10000000000 are ${cifrePutere2(10_000_000_000)} cifre`);De ce merge
Pentru exponentul de zece miliarde, rezultatul exact ar avea zece miliarde de biți, mult peste limita lui BigInt din V8, deci calculul nu poate fi făcut. Nici nu e nevoie de el: numărul de cifre zecimale al lui 2^n este partea întreagă din n · log10(2), plus 1. Formula dă instant 20 pentru 2^64 și peste trei miliarde pentru exponentul mare.
Alte forme ale mesajului
RangeError: BigInt is too large to allocateRangeError: Maximum BigInt size exceeded at BigInt.exponentiateRangeError: Maximum BigInt size exceeded at BigInt.leftShift
Cum o eviți pe viitor
- Verifică exponenții și deplasările înainte de calcul: pune o limită rezonabilă și aruncă o eroare clară dacă e depășită.
- Lucrează cu unități consecvente (secunde sau milisecunde, biți sau octeți) și pune unitatea în numele variabilei.
- Folosește
BigIntdoar când ai nevoie de precizie exactă pe întregi mari. - Pentru estimări, folosește
Numberși logaritmi.
Întrebări frecvente
Care e exact limita?
Depinde de motor și de versiune. În V8 e în jur de un miliard de biți, adică aproximativ 300 de milioane de cifre zecimale. Codul tău nu ar trebui să ajungă aproape de ea.
De ce nu primesc Infinity ca la Number?
BigInt nu are valori speciale precum Infinity sau NaN. Când rezultatul nu poate fi reprezentat, singura variantă e o eroare.
Erori înrudite
RangeError: Division by zero Ai împărțit (sau ai calculat restul cu %) un BigInt la 0n. La numerele obișnuite 5 / 0 dă Infinity, dar BigInt nu are Infinity, așa că aruncă RangeError. Verifică împărțitorul înainte (if (n === 0n)) și tratează cazul separat. TypeError: Cannot mix BigInt and other types, use explicit conversions Ai combinat un `BigInt` (de exemplu `10n`) cu un `Number` obișnuit într-o operație aritmetică: `10n + 1`. JavaScript nu le amestecă automat. Convertește explicit: `10n + 1n`, `10n + BigInt(x)` sau `Number(big) + 1` (doar dacă valoarea încape sigur într-un Number). 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. 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. Î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.
