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
- ECMAScript® Language Specification
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® Language Specification — Numbers and Dates
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® 2020 Language Specification
- Official reference — developer.mozilla.org: BigInt / toString