CKTIS / JavaScript
BigInt — presné celé čísla
BigInt(value) vytvára primitívnu hodnotu bigint na presné celočíselné výpočty mimo bezpečný rozsah Number. Zistite, ako funguje konverzia, aké obmedzenia platia pre aritmetické operácie a ako vytvárať text pomocou toString(radix).
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
BigInt(value)
123n
value.toString(radix)BigInt(value) vracia primitívnu hodnotu typu bigint, ktorá predstavuje celé číslo s ľubovoľnou presnosťou v rámci limitov zdrojov implementácie. Alternatívou je literál s príponou n, napríklad 123n. Funkcia a literály patria do ECMAScript 2020, nie do Web APIs. new BigInt(1) vyvolá TypeError. Jazyková špecifikácia nie je tabuľkou kompatibility prehliadačov; Node 24 v repozitári nedokazuje podporu v prehliadačoch.
Pri veľkých hodnotách použite text, napríklad BigInt("9007199254740993"): konverzia nedokáže vrátiť späť predchádzajúce zaokrúhlenie hodnoty Number. BigInt(1.5) vyvolá RangeError a neplatný text celého čísla vyvolá SyntaxError. Konverzia true vytvorí 1n, zatiaľ čo konverzia false vytvorí 0n.
Aritmetické operácie vyžadujú zhodné typy: 1n + 1 vyvolá TypeError, zatiaľ čo 1n + 1n vytvorí 2n. Celočíselné delenie skracuje zlomkovú časť smerom k nule: 7n / 2n vytvorí 3n. Konverzia pomocou Number(value) môže spôsobiť stratu presnosti.
Rozlišujte označenie BigInt.toString od metódy hodnoty: skutočné API je BigInt.prototype.toString, ktoré sa volá ako value.toString(radix). BigInt.toString() opisuje samotnú funkciu, nie formátovanie celého čísla. Metóda hodnoty vracia text bez prípony n; predvolený základ je 10. Pred kontrolou rozsahu metóda prevedie radix na celé číslo odrezaním zlomkovej časti smerom k nule. Ak je výsledok prevodu mimo rozsahu od 2 do 36 vrátane, metóda vyvolá RangeError. Napríklad (255n).toString(36.9) použije základ 36 a vráti "73".
Príklady
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());Výsledok
bigint 9007199254740995 ff 3
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
Zdroje
- 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