CKTIS / JavaScript
BigInt — natančna cela števila
BigInt(value) ustvari primitivno vrednost bigint za natančne celoštevilske izračune zunaj varnega območja Number. Spoznajte delovanje pretvorbe, omejitve aritmetičnih operacij in ustvarjanje besedila z metodo toString(radix).
Različica: 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) vrne primitivno vrednost tipa bigint, ki predstavlja celo število poljubne natančnosti v okviru omejitev virov implementacije. Druga možnost je literal s pripono n, na primer 123n. Funkcija in literali so del ECMAScript 2020, ne pa Web APIs. new BigInt(1) sproži TypeError. Jezikovna specifikacija ni tabela združljivosti brskalnikov; Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.
Za velike vrednosti uporabite besedilo, na primer BigInt("9007199254740993"): pretvorba ne more odpraviti predhodnega zaokroževanja vrednosti Number. BigInt(1.5) sproži RangeError, neveljavno besedilo celega števila pa sproži SyntaxError. Pretvorba true ustvari 1n, pretvorba false pa 0n.
Aritmetične operacije zahtevajo ujemajoče se tipe: 1n + 1 sproži TypeError, medtem ko 1n + 1n ustvari 2n. Celoštevilsko deljenje odreže ulomljeni del proti ničli: 7n / 2n ustvari 3n. Pretvorba z Number(value) lahko povzroči izgubo natančnosti.
Oznako BigInt.toString razlikujte od metode vrednosti: dejanski API je BigInt.prototype.toString, ki ga pokličemo kot value.toString(radix). BigInt.toString() opisuje samo funkcijo, ne pa oblikovanja celega števila. Metoda vrednosti vrne besedilo brez pripone n; privzeta osnova je 10. Pred preverjanjem razpona metoda pretvori radix v celo število, tako da odreže ulomljeni del v smeri proti ničli. Če je pretvorjena vrednost zunaj razpona od 2 do vključno 36, metoda sproži RangeError. Na primer, (255n).toString(36.9) uporabi osnovo 36 in vrne "73".
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.
Viri
- 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