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

RangeError: The number 1.5 cannot be converted to a BigInt because it is not an integer

Pe scurt

Ai apelat `BigInt(x)` cu un număr cu zecimale (sau `NaN`, `Infinity`). BigInt reține doar numere întregi. Rotunjește întâi (`BigInt(Math.round(x))`) sau lucrează în unități întregi, de exemplu bani în loc de lei.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

BigInt(valoare) creează un BigInt dintr-un Number sau dintr-un text. Pentru Number, valoarea trebuie să fie un întreg: BigInt(1.5) aruncă RangeError: The number 1.5 cannot be converted to a BigInt because it is not an integer, iar BigInt(NaN) și BigInt(Infinity) aruncă la fel. Pentru text, formatul trebuie să fie de număr întreg: BigInt("1.5") sau BigInt("abc") dau SyntaxError: Cannot convert 1.5 to a BigInt.

Cazuri tipice: un preț în lei cu bani (19.99) convertit direct în BigInt; rezultatul unei împărțiri (total / 3); o valoare citită dintr-un formular, cu virgulă sau spații.

Soluția e să decizi explicit cum rotunjești (Math.round, Math.floor, Math.trunc) sau să lucrezi de la început în unitatea cea mai mică (bani, cenți, wei).

De ce apare: cauzele frecvente

1Preț cu zecimale convertit direct

Greșit
JavaScript
const pret = 19.99;
const pretBig = BigInt(pret);
Corect
JavaScript
const pret = 19.99;
const pretBani = BigInt(Math.round(pret * 100)); // 1999n

Lucrezi în bani (întregi), iar Math.round elimină erorile de virgulă mobilă de la înmulțire.

2Rezultat de împărțire

Greșit
JavaScript
const parte = BigInt(100 / 3);
Corect
JavaScript
const parte = BigInt(Math.floor(100 / 3)); // 33n
// sau: 100n / 3n

Împărțirea Number dă zecimale. Rotunjește explicit sau împarte direct în BigInt.

3Text cu zecimale

Greșit
JavaScript
const sold = BigInt("250.50");
Corect
JavaScript
const sold = BigInt("25050"); // bani
// sau BigInt(Math.round(Number("250.50") * 100))

Din text, BigInt acceptă doar cifrele unui întreg; altfel aruncă SyntaxError: Cannot convert 250.50 to a BigInt.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos ține prețurile în bani, ca BigInt, dar se oprește cu RangeError: The number 19.99 cannot be converted to a BigInt because it is not an integer. Repară funcția inBani ca programul să afișeze Total: 4498 bani și Total: 44.98 lei.

Codul care dă eroarea
JavaScript
function inBani(lei) {
  return BigInt(lei);
}

const cos = [19.99, 24.99];
const total = cos.map(inBani).reduce((a, b) => a + b, 0n);

console.log(`Total: ${total} bani`);
console.log(`Total: ${total / 100n}.${String(total % 100n).padStart(2, "0")} lei`);
După reparație, programul afișează
Total: 4498 bani
Total: 44.98 lei
Indiciu

Transformă întâi prețul în bani (× 100) și rotunjește-l la întreg înainte de BigInt.

Alte forme ale mesajului

  • SyntaxError: Cannot convert 1.5 to a BigInt
  • RangeError: The number NaN cannot be converted to a BigInt because it is not an integer
  • RangeError: 1.5 can't be converted to BigInt because it isn't an integer
  • SyntaxError: Cannot convert abc to a BigInt

Cum o eviți pe viitor

  • Păstrează banii în unitatea cea mai mică (bani, cenți), ca întregi.
  • Înainte de BigInt(x), verifică Number.isInteger(x) sau rotunjește explicit.
  • Curăță textele venite din formulare (spații, virgulă) înainte de conversie.

Întrebări frecvente

De ce nu rotunjește BigInt automat?

Ar trebui să aleagă o regulă (în jos, în sus, la cel mai apropiat), iar o alegere greșită pierde bani sau date. Limbajul te obligă să alegi tu.

Ce fac dacă am nevoie de zecimale foarte precise?

BigInt nu are zecimale. Folosește o bibliotecă de numere zecimale (de exemplu decimal.js) sau lucrează în întregi cu un factor fix (× 100, × 10⁶).

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.