Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

BigInt — interi esatti

BigInt(value) crea un valore primitivo bigint per eseguire calcoli interi esatti oltre l’intervallo sicuro di Number. Scopri come funziona la conversione, quali restrizioni si applicano alle operazioni aritmetiche e come produrre testo con toString(radix).

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

BigInt(value)
123n
value.toString(radix)

BigInt(value) restituisce un valore primitivo di tipo bigint, che rappresenta un intero a precisione arbitraria entro i limiti delle risorse dell’implementazione. In alternativa si può usare un letterale con il suffisso n, ad esempio 123n. La funzione e i letterali fanno parte di ECMAScript 2020, non delle Web APIs. new BigInt(1) genera un TypeError. La specifica del linguaggio non è una tabella di compatibilità dei browser; la presenza di Node 24 in un repository non dimostra il supporto nei browser.

Per i valori grandi, usa il testo, ad esempio BigInt("9007199254740993"): la conversione non può annullare un precedente arrotondamento di un valore Number. BigInt(1.5) genera un RangeError, mentre un testo intero non valido genera un SyntaxError. La conversione di true produce 1n, mentre quella di false produce 0n.

Le operazioni aritmetiche richiedono tipi corrispondenti: 1n + 1 genera un TypeError, mentre 1n + 1n produce 2n. La divisione intera tronca la parte frazionaria verso zero: 7n / 2n produce 3n. La conversione tramite Number(value) può causare una perdita di precisione.

Distingui l’etichetta BigInt.toString dal metodo applicato ai valori: l’API effettiva è BigInt.prototype.toString, chiamata come value.toString(radix). BigInt.toString() descrive la funzione stessa, invece di formattare un intero. Il metodo applicato al valore restituisce testo senza il suffisso n; la base predefinita è 10. Prima di verificare l’intervallo, il metodo converte radix in un intero mediante troncamento verso zero. Se il valore ottenuto non è compreso tra 2 e 36 inclusi, il metodo genera un RangeError. Ad esempio, (255n).toString(36.9) usa la base 36 e restituisce "73".

Esempi

const value = BigInt("9007199254740993");
const next = value + 2n;
console.log(typeof value);
console.log(next.toString());
console.log((255n).toString(16));
console.log((7n / 2n).toString());

Risultato

bigint
9007199254740995
ff
3

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti