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

TypeError: Cannot convert a BigInt value to a number

Pe scurt

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

Greșit
JavaScript
const vanzari = [120n, 340n, 90n];
const maxim = Math.max(...vanzari);
Corect
JavaScript
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

Greșit
JavaScript
const id = 42n;
const n = +id;
Corect
JavaScript
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()

Greșit
JavaScript
const ns = process.hrtime.bigint() - start;
console.log(Math.round(ns / 1e6) + " ms");
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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}`);
După reparație, programul afișează
Maxim: 340
Total: 550
Indiciu

BigInt-urile se pot compara direct cu >; un reduce poate păstra la fiecare pas valoarea mai mare.

Alte forme ale mesajului

  • TypeError: can't convert BigInt to number
  • TypeError: Cannot convert a BigInt value to a number at Math.max
  • TypeError: 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.*, +x sau parseFloat pe 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

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