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

TypeError: Cannot convert 1 to a BigInt

Pe scurt

Ai pus un Number obișnuit acolo unde e obligatoriu un BigInt: într-un BigInt64Array / BigUint64Array, în DataView.setBigInt64 sau în BigInt.asIntN. Aceste API-uri nu convertesc automat. Transformă valoarea cu BigInt(valoare) sau scrie literalul cu n: 1n.

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

Ce înseamnă

Unele API-uri lucrează doar cu BigInt: tablourile BigInt64Array și BigUint64Array, metodele DataView.setBigInt64 / setBigUint64, funcțiile BigInt.asIntN și BigInt.asUintN, Atomics pe tablouri BigInt. Ele acceptă 1n, nu 1. Dacă primesc un Number, nu îl convertesc singure, ci aruncă Cannot convert 1 to a BigInt. Valoarea din mesaj e cea primită.

Situația e inversă față de Cannot mix BigInt and other types: acolo amesteci tipurile într-o operație, aici dai un Number unui loc rezervat pentru BigInt. Apare când umpli un tablou de 64 de biți cu valori dintr-un tablou obișnuit, când folosești fill(0) sau când citești ID-uri ori sume dintr-un JSON (unde sunt Number) și le scrii într-un buffer binar.

Reparația e BigInt(valoare) pentru fiecare element sau literalul 0n. Atenție: BigInt(1.5) aruncă altă eroare, pentru că BigInt nu are zecimale.

De ce apare: cauzele frecvente

1Tablou BigInt umplut cu numere obișnuite

Greșit
JavaScript
const iduri = new BigUint64Array([1, 2, 3]);
Corect
JavaScript
const iduri = BigUint64Array.from([1, 2, 3], BigInt);

from cu funcția BigInt convertește fiecare element înainte să-l pună în tablou.

2fill sau atribuire cu Number

Greșit
JavaScript
const sume = new BigInt64Array(3);
sume.fill(0);
sume[0] = 100;
Corect
JavaScript
const sume = new BigInt64Array(3);
sume.fill(0n);
sume[0] = 100n;

Literalul cu n creează direct un BigInt.

3Scriere într-un DataView

Greșit
JavaScript
const v = new DataView(new ArrayBuffer(8));
v.setBigUint64(0, Date.now());
Corect
JavaScript
const v = new DataView(new ArrayBuffer(8));
v.setBigUint64(0, BigInt(Date.now()));

Date.now() întoarce un Number. Îl convertești explicit pentru metoda de 64 de biți.

Repară tu

Repară eroarea, direct în pagină

Programul păstrează ID-urile comenzilor într-un BigUint64Array, dar îl creează direct din numerele primite și primește TypeError: Cannot convert 1001 to a BigInt. Repară crearea tabloului ca fiecare ID să fie convertit în BigInt, iar programul să afișeze ID-urile și pe cel mai mare.

Codul care dă eroarea
JavaScript
const primite = [1001, 1002, 1005];

const iduri = new BigUint64Array(primite);
const maxim = iduri.reduce((m, id) => (id > m ? id : m), 0n);

console.log(`ID-uri: ${iduri.join(", ")}`);
console.log(`Cel mai mare: ${maxim}`);
După reparație, programul afișează
ID-uri: 1001, 1002, 1005
Cel mai mare: 1005
Indiciu

BigUint64Array.from acceptă o funcție de conversie ca al doilea argument.

Alte forme ale mesajului

  • TypeError: Cannot convert 0 to a BigInt
  • TypeError: Cannot convert 5 to a BigInt
  • TypeError: can't convert 1 to BigInt
  • TypeError: Cannot convert undefined to a BigInt

Cum o eviți pe viitor

  • Când lucrezi cu tablouri de 64 de biți, convertește datele la intrare: Tablou.from(valori, BigInt).
  • Scrie literalii cu n (0n, 100n) în tot codul care lucrează cu BigInt.
  • Păstrează separat valorile Number și BigInt; convertește explicit, într-un singur loc.
  • Pentru sume de bani, ia în calcul să lucrezi în bani (întregi) cu Number, dacă valorile nu depășesc Number.MAX_SAFE_INTEGER.

Întrebări frecvente

De ce BigInt64Array nu convertește automat ca Int32Array?

Conversia automată din Number în BigInt ar putea pierde precizie sau ar ascunde zecimale. Specificația a ales să ceară conversie explicită, ca să știi sigur ce valoare scrii.

E la fel cu „Cannot convert 1.5 to a BigInt”?

Nu chiar. Aceea e o eroare a funcției BigInt() când primește un număr cu zecimale. Aici problema e că ai dat un Number unui API care cere direct BigInt.

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.