KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

BigInt — exacte gehele getallen

BigInt(value) maakt een bigint-primitief voor exacte gehele berekeningen buiten het veilige Number-bereik. Ontdek hoe conversie werkt, welke beperkingen gelden voor rekenkundige bewerkingen en hoe je tekst maakt met toString(radix).

Versie: 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) geeft een primitieve waarde van het type bigint terug, die een geheel getal met willekeurige precisie voorstelt binnen de resourcebeperkingen van de implementatie. Een alternatief is een literal met het achtervoegsel n, zoals 123n. De functie en literals horen bij ECMAScript 2020, niet bij Web APIs. new BigInt(1) veroorzaakt een TypeError. De taalspecificatie is geen browsercompatibiliteitstabel; Node 24 in een repository bewijst niet dat browsers ondersteuning bieden.

Gebruik voor grote waarden tekst, zoals BigInt("9007199254740993"): conversie kan eerdere afronding van een Number-waarde niet ongedaan maken. BigInt(1.5) veroorzaakt een RangeError, en ongeldige tekst voor een geheel getal veroorzaakt een SyntaxError. Conversie van true levert 1n op, terwijl conversie van false 0n oplevert.

Rekenkundige bewerkingen vereisen overeenkomende typen: 1n + 1 veroorzaakt een TypeError, terwijl 1n + 1n 2n oplevert. Gehele deling kapt het fractionele deel af in de richting van nul: 7n / 2n levert 3n op. Conversie via Number(value) kan precisieverlies veroorzaken.

Maak onderscheid tussen de aanduiding BigInt.toString en de methode voor waarden: de daadwerkelijke API is BigInt.prototype.toString, aangeroepen als value.toString(radix). BigInt.toString() beschrijft de functie zelf en formatteert geen geheel getal. De methode voor waarden geeft tekst zonder het achtervoegsel n terug; de standaardradix is 10. Voordat de methode het bereik controleert, zet ze radix om in een geheel getal door een eventueel fractioneel deel in de richting van nul af te kappen. Ligt de omgezette waarde buiten het bereik van 2 tot en met 36, dan veroorzaakt de methode een RangeError. Zo gebruikt (255n).toString(36.9) radix 36 en geeft die aanroep "73" terug.

Voorbeelden

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());

Resultaat

bigint
9007199254740995
ff
3

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen