Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Literał BigInt

Literał BigInt (BigInt literal) to zapis liczby całkowitej zakończony małą literą n, np. 42n. Tworzy wartość typu bigint bez zaokrąglania charakterystycznego dla dużych wartości Number.

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

0n; 42n; 0b101010n; 0o52n; 0x2An

Literał BigInt literal, np. 42n, tworzy wartość pierwotną typu bigint, a nie number. BigInt jest częścią ECMAScript 2020 i pozwala dokładnie reprezentować liczby całkowite wykraczające poza bezpieczny zakres Number.

Mała litera n musi bezpośrednio kończyć zapis liczby całkowitej. Obsługiwane są zapisy dziesiętne (42n), binarne (0b101010n), ósemkowe (0o52n) i szesnastkowe (0x2An). Zapisy 1.5n, 1e3n i 042n są niepoprawne składniowo. W -42n znak - jest operatorem jednoargumentowym, a nie częścią literału.

Operacje arytmetyczne takie jak + wymagają zgodnych typów: 42n + 1n działa, lecz 42n + 1 zgłasza TypeError. Dzielenie BigInt odrzuca część ułamkową w kierunku zera: 7n / 2n daje 3n. Konwersja dużej wartości do Number może utracić precyzję.

To składnia języka, nie Web API. Środowisko musi umieć ją parsować; w nieobsługiwanej przeglądarce plik z takim literałem nie zostanie wykonany. Obecność Node 24 w repozytorium nie dowodzi obsługi w przeglądarkach docelowych.

Przykłady

const value = 9007199254740993n;
console.log(typeof value);
console.log(String(value + 2n));
console.log(String(7n / 2n));
console.log(42n === 0x2An);

Wynik

bigint
9007199254740995
3
true

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

Źródła