CKTIS / JavaScript
Zahlentypen: Number und BigInt
JavaScript hat zwei primitive Zahlentypen: Number für Gleitkommaberechnungen und BigInt für Ganzzahlen ohne feste Bitbreite. Sie unterscheiden sich hinsichtlich Genauigkeit, Division und Konvertierungsregeln.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const value = 42;
const fraction = 0.5;
const integer = 42n;
Number(integer);
BigInt(value);Number stellt sowohl Ganzzahlen als auch Brüche im IEEE-754-Binary64-Format dar. Für gewöhnliche Ganzzahlliterale gibt es keinen eigenen int-Typ: typeof 42 gibt "number" zurück. Der Typ umfasst außerdem NaN, Infinity, -Infinity und zwei Nullen: +0 und -0. Viele Dezimalbrüche lassen sich nicht exakt darstellen, daher ergibt 0.1 + 0.2 === 0.3 den Wert false.
Der sichere Ganzzahlbereich von Number reicht von -(2 ** 53 - 1) bis 2 ** 53 - 1. Außerhalb dieses Bereichs lassen sich nicht alle aufeinanderfolgenden Ganzzahlen unterscheiden, auch wenn manche weiterhin exakt dargestellt werden. Verwende Number.isSafeInteger(value), um diese Eigenschaft zu prüfen.
BigInt stellt Ganzzahlen ohne feste Bitbreite dar; die praktisch möglichen Größen werden durch die Ressourcen der Implementierung begrenzt. Literale haben den Suffix n, zum Beispiel 42n, und typeof 42n gibt "bigint" zurück. Der Typ unterstützt weder Brüche noch NaN oder unendliche Werte. Bei der Division wird in Richtung null abgeschnitten: 5n / 2n ergibt 2n, während 5 / 2 den Wert 2.5 ergibt.
Mische diese Typen nicht in arithmetischen Ausdrücken: 2n + 3 löst einen TypeError aus. Konvertiere ausdrücklich mit BigInt(value) oder Number(value). Die Konvertierung einer nicht ganzzahligen Number zu BigInt löst einen RangeError aus; die Konvertierung in die andere Richtung kann Genauigkeit verlieren. Erzeuge große Ganzzahlen mit einem BigInt-Literal oder aus einer Zeichenfolge, nicht aus einer bereits gerundeten Number. Vergleiche verhalten sich anders als die Arithmetik: 2n === 2 ist false, aber 2n < 3 ist true.
Beispiele
console.log(typeof 42);
console.log(typeof 42n);
console.log(0.1 + 0.2 === 0.3);
console.log(Number.isSafeInteger(9007199254740992));
console.log(String(9007199254740993n + 1n));
console.log(5 / 2);
console.log(String(5n / 2n));
console.log(String(2n + BigInt(3)));
try {
console.log(2n + 3);
} catch (error) {
console.log(error.name);
}Ergebnis
number bigint false false 9007199254740994 2.5 2 5 TypeError
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.