WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Number.MAX_SAFE_INTEGER: obere Grenze sicherer Ganzzahlen

Number.MAX_SAFE_INTEGER hat exakt den Wert 2^53−1 beziehungsweise 9007199254740991 und markiert die positive Grenze sicherer Number-Ganzzahlen.

Version: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

Number.MAX_SAFE_INTEGER

Number.MAX_SAFE_INTEGER ist gleich 2 ** 53 - 1, exakt 9007199254740991. Ganzzahlige Number-Werte von Number.MIN_SAFE_INTEGER bis zu dieser Grenze sind sicher: Aufeinanderfolgende Ganzzahlen lassen sich ohne Rundungskollision darstellen. Die Konstante ist nicht die größte endliche Number; dafür steht das viel größere Number.MAX_VALUE.

2 ** 53 ist noch exakt darstellbar, gilt aber nicht als sicher, weil nicht mehr jede folgende Ganzzahl unterscheidbar ist. So ergeben Number.MAX_SAFE_INTEGER + 1 und Number.MAX_SAFE_INTEGER + 2 dieselbe Number. Eine Prüfung erst nach dem Konvertieren einer langen textuellen Kennung kann zu spät sein, weil beim Parsen bereits Genauigkeit verloren ging.

Die Eigenschaft existiert seit ECMAScript 2015 und ist nicht schreibbar, nicht aufzählbar und nicht konfigurierbar. Das Beispiel validiert eine nichtnegative Kennung mit Number.isSafeInteger und der expliziten Grenze und zeigt dann die erste Kollision. Bewahre größere Kennungen als Text oder nutze BigInt, statt sie in Number umzuwandeln.

Beispiele

const limit = Number.MAX_SAFE_INTEGER;
const validId = value => Number.isSafeInteger(value) && value >= 0 && value <= limit;

console.log(limit, limit === 2 ** 53 - 1);
console.log(limit + 1 === limit + 2);
console.log(validId(limit), validId(limit + 1));
const descriptor = Object.getOwnPropertyDescriptor(Number, "MAX_SAFE_INTEGER");
console.log(descriptor.writable, descriptor.enumerable, descriptor.configurable);

Ergebnis

9007199254740991 true
true
true false
false false false

Number.MAX_SAFE_INTEGER → Kennungsprüfung und erste Rundungskollision

Quellen