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")}}

js interactive-example
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: true

Value

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

js
Number.MAX_SAFE_INTEGER; // 9007199254740991

Relationship 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.

js
Number.MAX_SAFE_INTEGER * Number.EPSILON; // 1.9999999999999998

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • [Polyfill of Number.MAX_SAFE_INTEGER in core-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")}}