CKTIS / JavaScript
BigInt — přesná celá čísla
BigInt(value) vytváří primitivní hodnotu bigint pro přesné celočíselné výpočty mimo bezpečný rozsah Number. Zjistěte, jak funguje převod, jaká omezení platí pro aritmetické operace a jak vytvářet text pomocí toString(radix).
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
BigInt(value)
123n
value.toString(radix)BigInt(value) vrací primitivní hodnotu typu bigint, která představuje celé číslo s libovolnou přesností v rámci omezení prostředků implementace. Alternativou je literál s příponou n, například 123n. Funkce a literály patří do ECMAScript 2020, nikoli do Web APIs. new BigInt(1) vyvolá TypeError. Jazyková specifikace není tabulka kompatibility prohlížečů; Node 24 v repozitáři nedokládá podporu v prohlížečích.
U velkých hodnot použijte text, například BigInt("9007199254740993"): převod nedokáže vrátit zpět předchozí zaokrouhlení hodnoty Number. BigInt(1.5) vyvolá RangeError a neplatný text celého čísla vyvolá SyntaxError. Převod true vytvoří 1n, zatímco převod false vytvoří 0n.
Aritmetické operace vyžadují shodné typy: 1n + 1 vyvolá TypeError, zatímco 1n + 1n vytvoří 2n. Celočíselné dělení zkracuje zlomkovou část směrem k nule: 7n / 2n vytvoří 3n. Převod pomocí Number(value) může způsobit ztrátu přesnosti.
Rozlišujte označení BigInt.toString od metody hodnoty: skutečné API je BigInt.prototype.toString, které se volá jako value.toString(radix). BigInt.toString() popisuje samotnou funkci, místo aby formátovalo celé číslo. Metoda hodnoty vrací text bez přípony n; výchozí základ je 10. Před kontrolou rozsahu metoda převede radix na celé číslo oříznutím směrem k nule. Pokud je výsledek převodu mimo rozsah od 2 do 36 včetně, metoda vyvolá RangeError. Například (255n).toString(36.9) použije základ 36 a vrátí "73".
Pří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ýsledek
bigint 9007199254740995 ff 3
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.
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