TypeError: Cannot convert a BigInt value to a number
Ai dat un `BigInt` unei operații care cere implicit un Number: `Math.max(5n, 3n)`, `Math.round(x)`, `+x` (plus unar) sau o funcție care lucrează cu Number. Convertește explicit cu `Number(x)` dacă valoarea e mică, sau fă calculul cu operatori BigInt.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Unele operații transformă automat argumentele în Number: toate funcțiile din Math, plusul unar (+x), isNaN, metodele ca toFixed apelate prin Number.prototype, new Date(x), indicii unor API-uri. Pentru un BigInt, conversia implicită e interzisă, pentru că ar putea pierde precizia fără să-ți dai seama, așa că motorul aruncă Cannot convert a BigInt value to a number.
Conversia explicită cu Number(x) e permisă: o scrii când știi că valoarea încape (sub 2⁵³ − 1, adică Number.MAX_SAFE_INTEGER).
Eroarea apare des când primești BigInt dintr-o bibliotecă (drivere de baze de date pentru coloane BIGINT, biblioteci de blockchain, process.hrtime.bigint()) și le dai mai departe funcțiilor obișnuite.
De ce apare: cauzele frecvente
1Funcții Math cu BigInt
const vanzari = [120n, 340n, 90n];
const maxim = Math.max(...vanzari);const vanzari = [120n, 340n, 90n];
const maxim = vanzari.reduce((a, b) => (b > a ? b : a));Math.max cere Number. Comparația > funcționează direct pe BigInt.
2Plus unar pentru conversie
const id = 42n;
const n = +id;const id = 42n;
const n = Number(id);+x e conversie implicită, interzisă pentru BigInt. Number(x) e explicită și permisă.
3Timp măsurat cu hrtime.bigint()
const ns = process.hrtime.bigint() - start;
console.log(Math.round(ns / 1e6) + " ms");const ns = process.hrtime.bigint() - start;
console.log(Number(ns / 1000000n) + " ms");Împarți în BigInt (1000000n), iar rezultatul mic îl convertești explicit.
Repară eroarea, direct în pagină
Programul de mai jos primește vânzările zilnice ca BigInt (de la o bază de date) și vrea să afișeze maximul, dar se oprește cu TypeError: Cannot convert a BigInt value to a number. Repară calculul maximului, fără Math.max, ca programul să afișeze Maxim: 340 și Total: 550.
const vanzari = [120n, 340n, 90n];
const maxim = Math.max(...vanzari);
const total = vanzari.reduce((a, b) => a + b, 0n);
console.log(`Maxim: ${maxim}`);
console.log(`Total: ${total}`);Maxim: 340 Total: 550
Indiciu
BigInt-urile se pot compara direct cu >; un reduce poate păstra la fiecare pas valoarea mai mare.
Reparația
const vanzari = [120n, 340n, 90n];
const maxim = vanzari.reduce((a, b) => (b > a ? b : a));
const total = vanzari.reduce((a, b) => a + b, 0n);
console.log(`Maxim: ${maxim}`);
console.log(`Total: ${total}`);De ce merge
Math.max încearcă să transforme fiecare argument în Number, iar conversia implicită a unui BigInt e interzisă. Comparația b > a funcționează însă direct între BigInt-uri, deci reduce păstrează la fiecare pas valoarea mai mare. Totalul mergea deja, pentru că pornea de la 0n și aduna doar BigInt-uri.
Alte forme ale mesajului
TypeError: can't convert BigInt to numberTypeError: Cannot convert a BigInt value to a number at Math.maxTypeError: Cannot convert a BigInt value to a number at Number.toFixed
Cum o eviți pe viitor
- Când primești BigInt dintr-o bibliotecă, decide imediat: îl păstrezi BigInt (și folosești doar operatori) sau îl convertești cu
Number(x). - Nu folosi
Math.*,+xsauparseFloatpe BigInt. - Înainte de
Number(x), verificăx <= BigInt(Number.MAX_SAFE_INTEGER)dacă valoarea poate fi mare.
Întrebări frecvente
Number(x) poate pierde precizie?
Da, pentru valori peste 2⁵³ − 1: Number(9007199254740993n) dă 9007199254740992. De aceea conversia e lăsată explicită, ca să o faci doar când știi că e sigură.
Cum afișez un BigInt cu separatori de mii?
x.toLocaleString("ro-RO") funcționează direct pe BigInt, fără conversie.
Erori înrudite
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: The number 1.5 cannot be converted to a BigInt because it is not an integer 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. TypeError: Do not know how to serialize a BigInt `JSON.stringify` a găsit o valoare `BigInt` (de exemplu `123n`), pe care JSON nu știe să o reprezinte. Transform-o în text (`valoare.toString()`) sau în număr, cu un replacer, înainte de serializare. Î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.
