WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Number.MIN_SAFE_INTEGER: untere Grenze sicherer Ganzzahlen

Number.MIN_SAFE_INTEGER hat exakt den Wert −(2^53−1) beziehungsweise -9007199254740991 und markiert die negative Grenze sicherer Number-Ganzzahlen.

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

Syntax

Number.MIN_SAFE_INTEGER

Number.MIN_SAFE_INTEGER ist gleich -(2 ** 53 - 1), exakt -9007199254740991. Ganzzahlige Number-Werte von dieser Grenze bis Number.MAX_SAFE_INTEGER sind sicher: Aufeinanderfolgende Ganzzahlen bleiben unterscheidbar. Die Konstante ist weder die negativste endliche Number -Number.MAX_VALUE noch Number.MIN_VALUE, das die kleinste positive subnormale Zahl bezeichnet.

-(2 ** 53) ist noch exakt darstellbar, aber keine sichere Ganzzahl, weil danach nicht mehr jede folgende Ganzzahl unterscheidbar bleibt. Number.MIN_SAFE_INTEGER - 1 und Number.MIN_SAFE_INTEGER - 2 ergeben dieselbe Number. Stammt ein negativer Wert aus langem Text, kann die Number-Konvertierung schon vor der Grenzprüfung Genauigkeit verlieren.

Die Eigenschaft existiert seit ECMAScript 2015 und ist nicht schreibbar, nicht aufzählbar und nicht konfigurierbar. Das Beispiel validiert eine vorzeichenbehaftete Korrektur im sicheren Bereich und zeigt die erste Kollision unterhalb der Grenze. Bewahre exakte Ganzzahlen größeren Betrags als Text oder nutze BigInt.

Beispiele

const limit = Number.MIN_SAFE_INTEGER;
const validAdjustment = value =>
  Number.isSafeInteger(value) && value >= limit && value <= Number.MAX_SAFE_INTEGER;

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

Ergebnis

-9007199254740991 true
true
true false
false false false

Number.MIN_SAFE_INTEGER → vorzeichenbehaftete Korrektur und untere Kollision

Quellen