CKTIS / JavaScript
Number.isSafeInteger: exact geheel getal in het veilige bereik
Number.isSafeInteger geeft true voor een gehele Number van -(2^53−1) tot en met 2^53−1, waar binary64 gehele precisie behoudt.
Versie: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Number.isSafeInteger(number)Number.isSafeInteger(value) vereist een eindige, gehele waarde van het type Number en Math.abs(value) <= Number.MAX_SAFE_INTEGER. Number.MAX_SAFE_INTEGER en Number.MIN_SAFE_INTEGER slagen dus, waarden daarbuiten niet; +0 en -0 zijn veilig. NaN, oneindigheden en Numbers met een gerepresenteerd breukdeel geven false.
De methode voert geen coercion uit, dus tekenreeksen, BigInt, Symbol, objecten en wrappers uit new Number(...) leveren false. Ze controleert de al opgeslagen binary64-waarde, niet de oorspronkelijke tekst vóór parsing. Een veilig huidig operand garandeert geen veilig volgend resultaat: 1 optellen bij Number.MAX_SAFE_INTEGER verlaat het bereik, waarna verschillende wiskundige gehele getallen naar dezelfde Number kunnen afronden.
De methode bestaat sinds ECMAScript 2015 en is geen constructor. Het voorbeeld verhoogt een niet-negatief volgnummer alleen als het resultaat veilig blijft en wijst de grenswaarde af. Gebruik BigInt of een decimale representatie voor tellers, identifiers of bedragen buiten het bereik; BigInt is exact, maar Number.isSafeInteger geeft er bewust false voor.
Voorbeelden
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));Resultaat
42 null true false true false false
Number.isSafeInteger → volgnummer veilig verhogen