CKTIS / JavaScript
Number.isSafeInteger: exakte Ganzzahl im sicheren Bereich
Number.isSafeInteger liefert true für eine ganzzahlige Number von -(2^53−1) bis 2^53−1, in dem binary64 Ganzzahlgenauigkeit bewahrt.
Version: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Number.isSafeInteger(number)Number.isSafeInteger(value) verlangt eine endliche, ganzzahlige Number und Math.abs(value) <= Number.MAX_SAFE_INTEGER. Daher bestehen Number.MAX_SAFE_INTEGER und Number.MIN_SAFE_INTEGER, Werte außerhalb dieses Bereichs aber nicht; +0 und -0 sind sicher. NaN, Unendlichkeiten und Numbers mit dargestelltem Bruchteil ergeben false.
Die Methode führt keine Koercion aus; Zeichenketten, BigInt, Symbol, Objekte und Wrapper aus new Number(...) ergeben false. Sie prüft den bereits gespeicherten binary64-Wert, nicht den ursprünglichen Text vor dem Parsen. Ein sicherer aktueller Operand garantiert kein sicheres nächstes Ergebnis: 1 zu Number.MAX_SAFE_INTEGER zu addieren verlässt den Bereich, danach können verschiedene mathematische Ganzzahlen auf dieselbe Number runden.
Die Methode existiert seit ECMAScript 2015 und ist kein Konstruktor. Das Beispiel erhöht eine nichtnegative Sequenznummer nur, wenn auch das Ergebnis sicher bleibt, und weist den Grenzwert zurück. Für Zähler, Kennungen oder Beträge jenseits des Bereichs nutze BigInt oder eine Dezimaldarstellung; BigInt ist exakt, doch Number.isSafeInteger liefert dafür absichtlich false.
Beispiele
function nextSequence(value) {
if (!Number.isSafeInteger(value) || value < 0 || value >= Number.MAX_SAFE_INTEGER) return null;
return value + 1;
}
console.log(nextSequence(41), nextSequence(Number.MAX_SAFE_INTEGER));
console.log(Number.isSafeInteger(Number.MAX_SAFE_INTEGER), Number.isSafeInteger(Number.MAX_SAFE_INTEGER + 1));
console.log(Number.isSafeInteger(-0), Number.isSafeInteger("42"), Number.isSafeInteger(42n));Ergebnis
42 null true false true false false
Number.isSafeInteger → Sequenznummer sicher erhöhen