CKTIS / JavaScript
BigInt — točni cijeli brojevi
BigInt(value) stvara primitivnu vrijednost bigint za točne cjelobrojne izračune izvan sigurnog raspona Number. Saznajte kako funkcionira pretvorba, koja ograničenja vrijede za aritmetičke operacije i kako stvoriti tekst pomoću toString(radix).
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
BigInt(value)
123n
value.toString(radix)BigInt(value) vraća primitivnu vrijednost tipa bigint, koja predstavlja cijeli broj proizvoljne preciznosti unutar ograničenja resursa implementacije. Druga je mogućnost literal sa sufiksom n, primjerice 123n. Funkcija i literali dio su ECMAScript 2020, a ne Web APIs. new BigInt(1) izaziva TypeError. Jezična specifikacija nije tablica kompatibilnosti preglednika; Node 24 u repozitoriju ne dokazuje podršku u preglednicima.
Za velike vrijednosti upotrijebite tekst, primjerice BigInt("9007199254740993"): pretvorba ne može poništiti prethodno zaokruživanje vrijednosti Number. BigInt(1.5) izaziva RangeError, a nevaljan tekst cijelog broja izaziva SyntaxError. Pretvorba vrijednosti true daje 1n, dok pretvorba vrijednosti false daje 0n.
Aritmetičke operacije zahtijevaju podudarne tipove: 1n + 1 izaziva TypeError, dok 1n + 1n daje 2n. Cjelobrojno dijeljenje odbacuje decimalni dio prema nuli: 7n / 2n daje 3n. Pretvorba pomoću Number(value) može uzrokovati gubitak preciznosti.
Razlikujte naziv BigInt.toString od metode vrijednosti: stvarni API je BigInt.prototype.toString, koji se poziva kao value.toString(radix). BigInt.toString() opisuje samu funkciju, a ne formatira cijeli broj. Metoda vrijednosti vraća tekst bez sufiksa n; zadana je baza 10. Prije provjere raspona metoda pretvara radix u cijeli broj odbacivanjem razlomljenog dijela prema nuli. Ako je dobivena vrijednost izvan raspona od 2 do 36, uključujući obje granice, metoda izaziva RangeError. Primjerice, (255n).toString(36.9) koristi bazu 36 i vraća "73".
Primjeri
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());Rezultat
bigint 9007199254740995 ff 3
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.
Izvori
- 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