CKTIS / JavaScript
Number.MAX_SAFE_INTEGER: bovengrens voor veilige gehele getallen
Number.MAX_SAFE_INTEGER heeft exact de waarde 2^53−1, of 9007199254740991, en markeert de positieve grens van veilige Number-gehele getallen.
Versie: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Number.MAX_SAFE_INTEGERNumber.MAX_SAFE_INTEGER is gelijk aan 2 ** 53 - 1, exact 9007199254740991. Gehele Number-waarden van Number.MIN_SAFE_INTEGER tot en met deze grens zijn veilig: opeenvolgende gehele getallen kunnen zonder afrondingsbotsing worden weergegeven. De constante is niet de grootste eindige Number; dat is de veel grotere Number.MAX_VALUE.
2 ** 53 is nog exact representeerbaar, maar geldt niet als veilig omdat niet elk volgend geheel getal onderscheidbaar blijft. Zo produceren Number.MAX_SAFE_INTEGER + 1 en Number.MAX_SAFE_INTEGER + 2 dezelfde Number. Pas controleren na conversie van een lange tekstuele identifier kan te laat zijn, omdat bij parsing al precisie verloren kan zijn.
De eigenschap bestaat sinds ECMAScript 2015 en is niet schrijfbaar, niet opsombaar en niet configureerbaar. Het voorbeeld valideert een niet-negatieve identifier met Number.isSafeInteger en de expliciete grens en toont daarna de eerste botsing. Bewaar grotere identifiers als tekst of gebruik BigInt in plaats van ze naar Number te converteren.
Voorbeelden
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);Resultaat
9007199254740991 true true true false false false false
Number.MAX_SAFE_INTEGER → identifiervalidatie en eerste afrondingsbotsing