Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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