Number.isSafeInteger()

Number.isSafeInteger() 静态方法判断提供的值是否是一个安全整数

尝试一下

语法

js
Number.isSafeInteger(testValue)

参数

testValue

要测试是否为安全整数的值。

返回值

如果给定的值是一个安全整数,则返回布尔值 true。否则返回 false

描述

安全整数由 -(253 - 1) 到 253 - 1 的所有整数组成,包含(±9,007,199,254,740,991)。安全整数是符合以下条件的整数:

  • 可以精确地表示为 IEEE-754 双精度数,并且
  • 其 IEEE-754 表示形式不能是舍入任何其他整数以适应 IEEE-754 表示形式的结果。

例如,253 - 1 是一个安全整数:它可以精确地表示,并且在任何 IEEE-754 舍入模式下都没有其他整数舍入结果为该整数。相比之下,253 不是一个安全整数:它可以在 IEEE-754 中精确地表示,但整数 253 + 1 不能直接在 IEEE-754 中表示,而是采用就近舍入和向零舍入时,会舍入到 253

处理大约 9 千万亿左右的值时,需要使用任意精度算术库来实现完全精确性。有关浮点数表示的更多信息,请参阅程序员需要了解的浮点数算术知识

对于更大的整数,请考虑使用 BigInt 类型。

示例

使用 isSafeInteger()

js
Number.isSafeInteger(3); // true
Number.isSafeInteger(2 ** 53); // false
Number.isSafeInteger(2 ** 53 - 1); // true
Number.isSafeInteger(NaN); // false
Number.isSafeInteger(Infinity); // false
Number.isSafeInteger("3"); // false
Number.isSafeInteger(3.1); // false
Number.isSafeInteger(3.0); // true

规范

Specification
ECMAScript Language Specification
# sec-number.issafeinteger

浏览器兼容性

BCD tables only load in the browser

参见