CKTIS / JavaScript
Number.isSafeInteger: natančno celo število v varnem območju
Number.isSafeInteger vrne true za celoštevilski Number od -(2^53−1) do 2^53−1, kjer binary64 ohranja celoštevilsko natančnost.
Različica: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaksa
Number.isSafeInteger(number)Number.isSafeInteger(value) zahteva končno celoštevilsko vrednost vrste Number in Math.abs(value) <= Number.MAX_SAFE_INTEGER. Zato Number.MAX_SAFE_INTEGER in Number.MIN_SAFE_INTEGER uspeta, vrednosti zunaj območja pa ne; +0 in -0 sta varni. NaN, neskončnosti in Numbers s predstavljenim ulomljenim delom dajo false.
Metoda ne izvaja pretvorbe, zato nizi, BigInt, Symbol, objekti in ovoji new Number(...) dajo false. Preveri že shranjeno vrednost binary64, ne izvirnega besedila pred razčlenjevanjem. Varen trenutni operand ne zagotavlja varnega naslednjega rezultata: prištevanje 1 k Number.MAX_SAFE_INTEGER zapusti območje, nato pa se lahko različna matematična cela števila zaokrožijo v isti Number.
Metoda obstaja od ECMAScript 2015 in ni konstruktor. Primer poveča nenegativno zaporedno številko le, če bo varen tudi rezultat, in zavrne mejno vrednost. Za števce, identifikatorje ali zneske zunaj območja uporabite BigInt ali decimalno predstavitev; BigInt je natančen, vendar Number.isSafeInteger zanj namenoma vrne false.
Primeri
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));Rezultat
42 null true false true false false
Number.isSafeInteger → varno povečanje zaporedne številke