Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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