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.