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

TypeError: Cannot mix BigInt and other types, use explicit conversions

Pe scurt

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

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

Ce înseamnă

BigInt e un tip numeric separat, pentru numere întregi oricât de mari (cu n la final: 9007199254740993n). Number e tipul obișnuit, cu zecimale, dar precis doar până la 2⁵³ − 1. Ca să nu pierzi precizia în tăcere, operatorii + - * / % ** refuză să combine cele două tipuri și aruncă Cannot mix BigInt and other types, use explicit conversions.

Comparațiile (<, >, ==) și concatenarea cu texte ("total: " + 5n) sunt permise. Doar aritmetica cere același tip.

Cazuri tipice: ID-uri mari sau sume în bani ținute ca BigInt (de exemplu din baze de date sau din blockchain, în wei), la care adaugi un număr literal (+ 1); rezultatul unui Date.now() sau al unui length combinat cu BigInt.

De ce apare: cauzele frecvente

1Literal Number adunat la un BigInt

Greșit
JavaScript
let id = 9007199254740993n;
id = id + 1;
Corect
JavaScript
let id = 9007199254740993n;
id = id + 1n;

Literalul 1n e tot BigInt, deci operația e între același tip.

2Variabilă Number combinată cu BigInt

Greșit
JavaScript
const sold = 1500000000000000000n; // wei
const bucati = 3;
const total = sold * bucati;
Corect
JavaScript
const sold = 1500000000000000000n;
const bucati = 3;
const total = sold * BigInt(bucati);

BigInt(bucati) convertește explicit întregul la BigInt.

3Calcul cu zecimale pe BigInt

Greșit
JavaScript
const pretBani = 1999n;
const cuTva = pretBani * 1.19;
Corect
JavaScript
const pretBani = 1999n;
const cuTva = (pretBani * 119n) / 100n;

BigInt nu are zecimale. Lucrezi în unități întregi (bani, procente × 100) și împarți la final.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos calculează următorul ID de comandă, care e un număr foarte mare ținut ca BigInt, dar se oprește cu TypeError: Cannot mix BigInt and other types, use explicit conversions. Repară calculul ca programul să afișeze Următorul ID: 9007199254740994 și ID-uri rezervate: 9007199254740994 - 9007199254741003.

Codul care dă eroarea
JavaScript
const ultimulId = 9007199254740993n;
const rezervate = 10;

const urmator = ultimulId + 1;
const ultimulRezervat = urmator + rezervate - 1;

console.log(`Următorul ID: ${urmator}`);
console.log(`ID-uri rezervate: ${urmator} - ${ultimulRezervat}`);
După reparație, programul afișează
Următorul ID: 9007199254740994
ID-uri rezervate: 9007199254740994 - 9007199254741003
Indiciu

Toți termenii din operație trebuie să fie BigInt: literalii se scriu cu n, iar variabilele Number se convertesc cu BigInt(...).

Alte forme ale mesajului

  • TypeError: can't convert BigInt to number
  • TypeError: Cannot mix BigInt and other types, use explicit conversions at Object.<anonymous>
  • TypeError: BigInts have no unsigned right shift, use >> instead

Cum o eviți pe viitor

  • Decide de la început ce tip folosește o valoare și păstrează-l: toate BigInt sau toate Number.
  • Scrie literalii cu n în calculele BigInt (1n, 100n).
  • Folosește BigInt doar când chiar ai nevoie (ID-uri sau sume peste 2⁵³); pentru restul, Number e suficient.
  • Atenție: împărțirea BigInt rotunjește spre zero (7n / 2n = 3n).

Întrebări frecvente

De ce 5n > 3 merge, dar 5n + 3 nu?

Comparația poate fi făcută exact între tipuri diferite, fără pierdere de precizie. Rezultatul unei adunări ar trebui însă să aibă un singur tip, iar limbajul nu vrea să aleagă în locul tău.

Pot folosi Math.max cu BigInt?

Nu. Funcțiile din Math lucrează doar cu Number și aruncă Cannot convert a BigInt value to a number. Pentru BigInt scrii comparația manual: a > b ? a : b.

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.