CKTIS / JavaScript
Number.isSafeInteger: točan cijeli broj u sigurnom rasponu
Number.isSafeInteger vraća true za cjelobrojni Number od -(2^53−1) do 2^53−1, gdje binary64 čuva cjelobrojnu preciznost.
Verzija: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaksa
Number.isSafeInteger(number)Number.isSafeInteger(value) zahtijeva konačnu cjelobrojnu vrijednost tipa Number i Math.abs(value) <= Number.MAX_SAFE_INTEGER. Zato Number.MAX_SAFE_INTEGER i Number.MIN_SAFE_INTEGER prolaze, a vrijednosti izvan raspona ne; +0 i -0 su sigurni. NaN, beskonačnosti i Numbers s predstavljenim razlomljenim dijelom daju false.
Metoda ne provodi pretvorbu, pa nizovi, BigInt, Symbol, objekti i omotači new Number(...) daju false. Provjerava već pohranjenu binary64 vrijednost, ne izvorni tekst prije parsiranja. Siguran trenutačni operand ne jamči siguran sljedeći rezultat: dodavanje 1 na Number.MAX_SAFE_INTEGER izlazi iz raspona, nakon čega se različiti matematički cijeli brojevi mogu zaokružiti na isti Number.
Metoda postoji od ECMAScript 2015 i nije konstruktor. Primjer povećava nenegativni redni broj samo ako će i rezultat ostati siguran te odbija graničnu vrijednost. Za brojače, identifikatore ili iznose izvan raspona koristi BigInt ili decimalni prikaz; BigInt je točan, ali Number.isSafeInteger za njega namjerno vraća false.
Primjeri
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 → sigurno povećavanje rednog broja