Number.MAX_SAFE_INTEGER
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
The **Number.MAX_SAFE_INTEGER** static data property represents the maximum safe integer in JavaScript (2<sup>53</sup> – 1).
For larger integers, consider using {{jsxref("BigInt")}}.
{{InteractiveExample("JavaScript Demo: Number.MAX_SAFE_INTEGER")}}
const x = Number.MAX_SAFE_INTEGER + 1;
const y = Number.MAX_SAFE_INTEGER + 2;
console.log(Number.MAX_SAFE_INTEGER);
// Expected output: 9007199254740991
console.log(x);
// Expected output: 9007199254740992
console.log(x === y);
// Expected output: trueValue
9007199254740991 (9,007,199,254,740,991, or \~9 quadrillion).
{{js_property_attributes(0, 0, 0)}}
Description
Double precision floating point format only has 52 bits to represent the mantissa, so it can only safely represent integers between -(2<sup>53</sup> – 1) and 2<sup>53</sup> – 1. "Safe" in this context refers to the ability to represent integers exactly and to compare them correctly. For example, Number.MAX_SAFE_INTEGER + 1 === Number.MAX_SAFE_INTEGER + 2 will evaluate to true, which is mathematically incorrect. See {{jsxref("Number.isSafeInteger()")}} for more information.
As mentioned in {{jsxref("Number.EPSILON")}}, the precision of numbers depends on their magnitude. Number.MAX_SAFE_INTEGER represents the largest value at which integer-level operations can be performed precisely, but you can still perform meaningful arithmetic on numbers larger than that, just without integer-level precision. The largest representable number in JavaScript is actually {{jsxref("Number.MAX_VALUE")}}, which is approximately 1.7976931348623157 × 10<sup>308</sup>.
Because MAX_SAFE_INTEGER is a static property of {{jsxref("Number")}}, you always use it as Number.MAX_SAFE_INTEGER, rather than as a property of a number value.
Examples
Return value of MAX_SAFE_INTEGER
Number.MAX_SAFE_INTEGER; // 9007199254740991Relationship between MAX_SAFE_INTEGER and EPSILON
{{jsxref("Number.EPSILON")}} is 2<sup>-52</sup>, while MAX_SAFE_INTEGER is 2<sup>53</sup> – 1 — both of them are derived from the width of the mantissa, which is 53 bits (with the highest bit always being 1). Multiplying them will give a value very close — but not equal — to 2.
Number.MAX_SAFE_INTEGER * Number.EPSILON; // 1.9999999999999998Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- [Polyfill of
Number.MAX_SAFE_INTEGERincore-js](https://core-js.io/docs/features/ecmascript/number) - [es-shims polyfill of
Number.MAX_SAFE_INTEGER](https://www.npmjs.com/package/es-constants) - {{jsxref("Number.MIN_SAFE_INTEGER")}}
- {{jsxref("Number.MAX_VALUE")}}
- {{jsxref("Number.isSafeInteger()")}}
- {{jsxref("BigInt")}}