Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Tipi numerici: Number e BigInt

JavaScript ha due tipi numerici primitivi: Number per i calcoli in virgola mobile e BigInt per gli interi senza una larghezza fissa in bit. Differiscono per precisione, divisione e regole di conversione.

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

const value = 42;
const fraction = 0.5;
const integer = 42n;
Number(integer);
BigInt(value);

Number rappresenta sia gli interi sia le frazioni nel formato IEEE 754 binary64. I normali letterali interi non hanno un tipo int separato: typeof 42 restituisce "number". Il tipo comprende anche NaN, Infinity, -Infinity e due zeri: +0 e -0. Molte frazioni decimali non possono essere rappresentate esattamente, quindi 0.1 + 0.2 === 0.3 dà false.

L’intervallo degli interi sicuri di Number va da -(2 ** 53 - 1) a 2 ** 53 - 1. Al di fuori di questo intervallo non è possibile distinguere tutti gli interi consecutivi, anche se alcuni sono ancora rappresentati esattamente. Usa Number.isSafeInteger(value) per verificare questa proprietà.

BigInt rappresenta interi senza una larghezza fissa in bit; in pratica, le dimensioni sono limitate dalle risorse dell’implementazione. I letterali hanno il suffisso n, per esempio 42n, e typeof 42n restituisce "bigint". Non supporta frazioni, NaN o infiniti. La divisione tronca verso zero: 5n / 2n produce 2n, mentre 5 / 2 produce 2.5.

Non mescolare questi tipi nelle operazioni aritmetiche: 2n + 3 genera un TypeError. Converti esplicitamente con BigInt(value) o Number(value). La conversione di un Number non intero in BigInt genera un RangeError, mentre quella inversa può comportare una perdita di precisione. Crea gli interi grandi da un letterale BigInt o da una stringa, non da un Number già arrotondato. I confronti differiscono dall’aritmetica: 2n === 2 è false, ma 2n < 3 è true.

Esempi

console.log(typeof 42);
console.log(typeof 42n);
console.log(0.1 + 0.2 === 0.3);
console.log(Number.isSafeInteger(9007199254740992));
console.log(String(9007199254740993n + 1n));
console.log(5 / 2);
console.log(String(5n / 2n));
console.log(String(2n + BigInt(3)));
try {
  console.log(2n + 3);
} catch (error) {
  console.log(error.name);
}

Risultato

number
bigint
false
false
9007199254740994
2.5
2
5
TypeError

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