Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Number.MIN_SAFE_INTEGER: dolna granica bezpiecznych liczb całkowitych

Number.MIN_SAFE_INTEGER ma dokładną wartość −(2^53−1), czyli -9007199254740991, i wyznacza ujemną granicę bezpiecznego zakresu całkowitego Number.

Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2

Składnia

Number.MIN_SAFE_INTEGER

Number.MIN_SAFE_INTEGER jest równe -(2 ** 53 - 1), czyli dokładnie -9007199254740991. Całkowite wartości Number od tej granicy do Number.MAX_SAFE_INTEGER są bezpieczne: kolejne liczby całkowite pozostają rozróżnialne. Stała nie jest najbardziej ujemnym skończonym Number, którym jest -Number.MAX_VALUE, ani Number.MIN_VALUE, które oznacza najmniejszą dodatnią wartość podnormalną.

-(2 ** 53) jest jeszcze dokładnie reprezentowalne, ale nie jest bezpieczną liczbą całkowitą, ponieważ dalej nie każda kolejna wartość jest rozróżnialna. Wyrażenia Number.MIN_SAFE_INTEGER - 1 i Number.MIN_SAFE_INTEGER - 2 dają ten sam Number. Gdy ujemna wartość pochodzi z długiego tekstu, konwersja do Number może utracić dokładność jeszcze przed sprawdzeniem granicy.

Właściwość istnieje od ECMAScript 2015 i jest niewritable, nieenumerowalna oraz niekonfigurowalna. Przykład waliduje podpisaną korektę w bezpiecznym zakresie i pokazuje pierwszą kolizję poniżej granicy. Dla większych co do modułu dokładnych liczb całkowitych zachowaj zapis tekstowy lub użyj BigInt.

Przykłady

const limit = Number.MIN_SAFE_INTEGER;
const validAdjustment = value =>
  Number.isSafeInteger(value) && value >= limit && value <= Number.MAX_SAFE_INTEGER;

console.log(limit, limit === -(2 ** 53 - 1));
console.log(limit - 1 === limit - 2);
console.log(validAdjustment(limit), validAdjustment(limit - 1));
const descriptor = Object.getOwnPropertyDescriptor(Number, "MIN_SAFE_INTEGER");
console.log(descriptor.writable, descriptor.enumerable, descriptor.configurable);

Wynik

-9007199254740991 true
true
true false
false false false

Number.MIN_SAFE_INTEGER → walidacja podpisanej korekty i dolna kolizja

Źródła