Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Number.MAX_SAFE_INTEGER: górna granica bezpiecznych liczb całkowitych

Number.MAX_SAFE_INTEGER ma dokładną wartość 2^53−1, czyli 9007199254740991, i wyznacza dodatnią granicę bezpiecznego zakresu całkowitego Number.

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

Składnia

Number.MAX_SAFE_INTEGER

Number.MAX_SAFE_INTEGER jest równe 2 ** 53 - 1, czyli dokładnie 9007199254740991. Wartości Number od Number.MIN_SAFE_INTEGER do tej granicy, jeśli są całkowite, są bezpiecznymi liczbami całkowitymi: mogą reprezentować kolejne liczby bez kolizji zaokrągleń. Stała nie jest maksymalną skończoną wartością Number; tę rolę pełni znacznie większe Number.MAX_VALUE.

2 ** 53 nadal jest dokładnie reprezentowalne, ale nie jest uznawane za bezpieczne, ponieważ nie każda kolejna liczba całkowita jest już rozróżnialna. Na przykład wyrażenia Number.MAX_SAFE_INTEGER + 1 i Number.MAX_SAFE_INTEGER + 2 dają ten sam Number. Sprawdzenie wartości dopiero po skonwertowaniu długiego tekstowego identyfikatora może być spóźnione, bo utrata precyzji mogła nastąpić podczas parsowania.

Właściwość istnieje od ECMAScript 2015 i jest niewritable, nieenumerowalna oraz niekonfigurowalna. Przykład waliduje nieujemny identyfikator przez Number.isSafeInteger i jawną granicę, a także pokazuje pierwszą kolizję. Dla większych identyfikatorów zachowaj tekst lub użyj BigInt zamiast konwertować je do Number.

Przykłady

const limit = Number.MAX_SAFE_INTEGER;
const validId = value => Number.isSafeInteger(value) && value >= 0 && value <= limit;

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

Wynik

9007199254740991 true
true
true false
false false false

Number.MAX_SAFE_INTEGER → walidacja identyfikatora i pierwsza kolizja zaokrągleń

Źródła