...
Eroare JavaScript · Numere, BigInt și formatare (Intl)

RangeError: Maximum BigInt size exceeded

Pe scurt

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

Greșit
JavaScript
const ms = 1_700_000_000_000;
const rezultat = 2n ** BigInt(ms);
Corect
JavaScript
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

Greșit
JavaScript
const cifre = (2n ** 10_000_000_000n).toString().length;
Corect
JavaScript
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ă

Greșit
JavaScript
const masca = 1n << BigInt(bitiTotal * 1024 ** 3);
Corect
JavaScript
const masca = 1n << BigInt(bitiTotal);

Deplasarea << e tot o înmulțire cu o putere a lui 2. Verifică unitatea valorii.

Repară tu

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.

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

Alte forme ale mesajului

  • RangeError: BigInt is too large to allocate
  • RangeError: Maximum BigInt size exceeded at BigInt.exponentiate
  • RangeError: 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 BigInt doar 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

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