CKTIS / JavaScript
Number.MAX_SAFE_INTEGER: horní mez bezpečných celých čísel
Number.MAX_SAFE_INTEGER má přesnou hodnotu 2^53−1 neboli 9007199254740991 a určuje kladnou mez bezpečných celých hodnot Number.
Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
Number.MAX_SAFE_INTEGERNumber.MAX_SAFE_INTEGER je rovno 2 ** 53 - 1, přesně 9007199254740991. Celočíselné hodnoty Number od Number.MIN_SAFE_INTEGER po tuto mez jsou bezpečné: po sobě jdoucí celá čísla lze reprezentovat bez kolizí zaokrouhlení. Konstanta není největší konečný Number; tím je mnohem větší Number.MAX_VALUE.
2 ** 53 je ještě přesně reprezentovatelné, ale není považováno za bezpečné, protože už nelze rozlišit všechna po sobě jdoucí celá čísla. Například Number.MAX_SAFE_INTEGER + 1 a Number.MAX_SAFE_INTEGER + 2 vytvoří stejný Number. Kontrola až po převodu dlouhého textového identifikátoru může přijít pozdě, protože při parsování už mohla být ztracena přesnost.
Vlastnost existuje od ECMAScript 2015 a není zapisovatelná, výčtová ani konfigurovatelná. Příklad ověří nezáporný identifikátor pomocí Number.isSafeInteger a explicitní meze a ukáže první kolizi. Větší identifikátory ponechte jako text nebo použijte BigInt místo převodu na Number.
Pří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ýsledek
9007199254740991 true true true false false false false
Number.MAX_SAFE_INTEGER → ověření identifikátoru a první kolize zaokrouhlení