Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

BigInt — dokładne liczby całkowite

BigInt(value) tworzy wartość prymitywną bigint do dokładnych obliczeń całkowitoliczbowych poza bezpiecznym zakresem Number. Poznaj konwersję danych, ograniczenia działań oraz zapis tekstowy przez toString(radix).

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

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

BigInt(value) zwraca wartość prymitywną typu bigint, reprezentującą liczbę całkowitą o dowolnej precyzji, w granicach zasobów implementacji. Alternatywą jest literał z sufiksem n, np. 123n. Funkcja i literały należą do ECMAScript 2020, a nie do Web APIs. new BigInt(1) zgłasza TypeError. Specyfikacja języka nie jest tabelą zgodności przeglądarek; obecność Node 24 w repozytorium nie potwierdza obsługi w przeglądarce.

Dla dużych wartości używaj tekstu, np. BigInt("9007199254740993"): wcześniejsze zaokrąglenie wartości Number nie zostanie cofnięte przez konwersję. BigInt(1.5) zgłasza RangeError, a niepoprawny tekst całkowitoliczbowy zgłasza SyntaxError. Konwersja true daje 1n, a false daje 0n.

Arytmetyka wymaga zgodnych typów: 1n + 1 zgłasza TypeError, natomiast 1n + 1n daje 2n. Dzielenie całkowitoliczbowe odrzuca część ułamkową w kierunku zera: 7n / 2n daje 3n. Konwersja przez Number(value) może utracić precyzję.

Określenie BigInt.toString należy odróżnić od metody wartości: właściwe API to BigInt.prototype.toString, wywoływane jako value.toString(radix). BigInt.toString() opisuje samą funkcję, nie formatuje liczby. Metoda wartości zwraca tekst bez sufiksu n; domyślną podstawą jest 10. Przed sprawdzeniem zakresu metoda przekształca argument radix w liczbę całkowitą, odrzucając część ułamkową w kierunku zera. Jeśli wynik konwersji jest poza zakresem od 2 do 36 włącznie, metoda zgłasza RangeError. Na przykład (255n).toString(36.9) używa podstawy 36 i zwraca "73".

Przykłady

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

Wynik

bigint
9007199254740995
ff
3

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

Źródła