CKTIS / JavaScript
Number.MAX_SAFE_INTEGER: horná hranica bezpečných celých čísel
Number.MAX_SAFE_INTEGER má presnú hodnotu 2^53−1, teda 9007199254740991, a určuje kladnú hranicu bezpečných celých hodnôt Number.
Verzia: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Number.MAX_SAFE_INTEGERNumber.MAX_SAFE_INTEGER sa rovná 2 ** 53 - 1, presne 9007199254740991. Celočíselné hodnoty Number od Number.MIN_SAFE_INTEGER po túto hranicu sú bezpečné: po sebe idúce celé čísla možno reprezentovať bez kolízií zaokrúhlenia. Konštanta nie je najväčší konečný Number; tým je omnoho väčší Number.MAX_VALUE.
2 ** 53 je ešte presne reprezentovateľné, ale nepovažuje sa za bezpečné, pretože už nemožno rozlíšiť všetky po sebe idúce celé čísla. Napríklad Number.MAX_SAFE_INTEGER + 1 a Number.MAX_SAFE_INTEGER + 2 vytvoria rovnaký Number. Kontrola až po prevode dlhého textového identifikátora môže prísť neskoro, lebo pri parsovaní už mohla byť stratená presnosť.
Vlastnosť existuje od ECMAScript 2015 a nie je zapisovateľná, vymenovateľná ani konfigurovateľná. Príklad overí nezáporný identifikátor pomocou Number.isSafeInteger a explicitnej hranice a ukáže prvú kolíziu. Väčšie identifikátory ponechaj ako text alebo použi BigInt namiesto prevodu na Number.
Príklady
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);Výsledok
9007199254740991 true true true false false false false
Number.MAX_SAFE_INTEGER → overenie identifikátora a prvá kolízia zaokrúhlenia