Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri