Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Typy liczbowe: Number i BigInt

JavaScript ma dwa pierwotne typy liczbowe: Number do obliczeń zmiennoprzecinkowych oraz BigInt do liczb całkowitych bez stałej szerokości bitowej. Różnią się precyzją, dzieleniem i zasadami konwersji.

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

Składnia

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

Number reprezentuje zarówno liczby całkowite, jak i ułamki w formacie IEEE 754 binary64. Nie ma osobnego typu int dla zwykłych literałów całkowitych: typeof 42 zwraca "number". Typ obejmuje też NaN, Infinity, -Infinity oraz dwa zera: +0 i -0. Wiele ułamków dziesiętnych nie ma dokładnej reprezentacji, dlatego 0.1 + 0.2 === 0.3 daje false.

Bezpieczny zakres całkowity Number wynosi od -(2 ** 53 - 1) do 2 ** 53 - 1. Poza nim nie wszystkie kolejne liczby całkowite dają się rozróżnić, choć niektóre nadal są reprezentowane dokładnie. Używaj Number.isSafeInteger(value) do sprawdzania tej właściwości.

BigInt reprezentuje liczby całkowite bez stałej szerokości bitowej; praktyczne rozmiary ograniczają zasoby implementacji. Literał ma przyrostek n, np. 42n, a typeof 42n zwraca "bigint". Nie obsługuje ułamków, NaN ani nieskończoności. Dzielenie obcina wynik w kierunku zera: 5n / 2n daje 2n, natomiast 5 / 2 daje 2.5.

Nie mieszaj tych typów w działaniach arytmetycznych: 2n + 3 zgłasza TypeError. Konwertuj jawnie przez BigInt(value) lub Number(value). Konwersja niecałkowitego Number do BigInt zgłasza RangeError, a odwrotna konwersja może utracić precyzję. Duże liczby całkowite twórz z literału BigInt lub tekstu, nie z już zaokrąglonego Number. Porównania są inne niż arytmetyka: 2n === 2 daje false, ale 2n < 3 daje true.

Przykłady

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);
}

Wynik

number
bigint
false
false
9007199254740994
2.5
2
5
TypeError

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła