JS 怎么使用 Number.isInteger() 判断整数

一、核心语法与基础使用方法

在 ES6 标准发布之前，JavaScript 开发者通常需要借助取模运算（如 val % 1 === 0）或向下取整对比来判断整数。这种做法不仅语法繁琐，而且极易在处理非数字类型时产生隐式转换漏洞。Number.isInteger() 的出现提供了标准、统一且安全的官方解决方案。

1. 语法签名

Number.isInteger(value);

• 参数 value：需要检测的目标数据。
• 返回值：布尔值。若 value 是整数则返回 true，否则均返回 false。

2. 基础测试示例

我们可以通过在终端 Node.js REPL 或浏览器开发者控制台中运行以下测试代码，直观观察其对正负整数、零以及浮点数的判断结果：

// 正整数、负整数与零
Number.isInteger(10);           // 示例输出: true
Number.isInteger(-25);          // 示例输出: true
Number.isInteger(0);            // 示例输出: true
Number.isInteger(-0);           // 示例输出: true

// 浮点数与小数形态
Number.isInteger(3.14);         // 示例输出: false
Number.isInteger(5.0);          // 示例输出: true （特别注意）
Number.isInteger(5.000000001);  // 示例输出: false

二、判定逻辑与执行机制剖析

要真正用好 Number.isInteger()，需要理解其内部的具体执行逻辑。与全局函数 parseInt() 或 isNaN() 不同，Number 对象上的方法严格遵循“无隐式转换”的设计准则。

根据 ECMAScript 官方规范，Number.isInteger(argument) 的底层算法可拆解为三个连贯的判定阶段：

1. 类型检查（Type Check）：首先检查 Type(argument) 是否为 Number。如果不是，立即返回 false。这也是 Number.isInteger("42") 返回 false 的根源所在。
2. 有限性检查（Finite Check）：若参数为 NaN、+Infinity 或 -Infinity，不属于有限实数，立即返回 false。
3. 取整一致性检查（Integer Value Check）：比较参数绝对值的取整结果是否等于其自身（即 floor(abs(argument)) === abs(argument)）。两者相等说明不存在有效小数部分，最终返回 true。

为了加深理解，我们可以通过官方规范中等价的 Polyfill 源码实现来印证这一逻辑：

// ECMAScript 官方等价 Polyfill 实现
if (!Number.isInteger) {
  Number.isInteger = function(value) {
    return typeof value === 'number' &&
           isFinite(value) &&
           Math.floor(value) === value;
  };
}

三、常见输入类型测试与传统方案避坑

在实际业务开发中，开发者经常需要处理来自 HTTP 请求体、表单字段或 URL 查询字符串的数据。如果误用过去的传统方法（如取模或全局解析），极易引发线上逻辑漏洞。

1. 传统方法的致命缺陷：隐式类型转换

在过去，很多代码库采用 val % 1 === 0 来检测整数。这种做法在处理纯数字时看似可行，但在处理非数字类型时，JavaScript 的取模运算符会将操作数强制转换为数值，从而造成严重误判：

// 传统取模运算的漏洞演示
"100" % 1 === 0;   // true (危险！字符串被隐式转换为数字 100)
null % 1 === 0;    // true (严重缺陷！null 被隐式转换为 0，0 % 1 === 0)
false % 1 === 0;   // true (严重缺陷！false 被隐式转换为 0)
"" % 1 === 0;      // true (严重缺陷！空字符串转为 0，表单未填写直接通过校验)

// 改用 Number.isInteger() 进行同类数据测试
Number.isInteger("100");  // false (安全拦截)
Number.isInteger(null);   // false (安全拦截)
Number.isInteger(false);  // false (安全拦截)
Number.isInteger("");     // false (安全拦截)

从对比矩阵可以清晰看出，Number.isInteger() 在所有非 number 类型的输入上均保持严格返回 false，彻底消除了由隐式转换带来的安全漏洞。

四、精度边界：Number.isInteger 与 Number.isSafeInteger

由于 JavaScript 内部采用 64 位双精度浮点数存储所有数值，其有效尾数位（Significand）为 52 位，配合 1 位隐含有效位，最多能精确表示 53 位二进制整数。这引出了两个不可忽视的边界范围：

• Number.MAX_SAFE_INTEGER：2^53 - 1，即 9007199254740991。
• Number.MIN_SAFE_INTEGER：-(2^53 - 1)，即 -9007199254740991。

在这个安全区间内，每一个整数都与 IEEE 754 的浮点值形成一一对应的单射关系，加减 1 运算绝对精确。然而，一旦超过这个区间，数值就会发生精度截断。

1. 为什么 isInteger() 会在超大数字上“失效”？

严格来说，并不是 Number.isInteger() 出现了 Bug，而是它忠实地执行了数学定义。当数值超出安全边界时，由于浮点精度丢失，相邻的奇数无法被单独表达，例如：

// 超过 2^53 - 1 的大数
const unsafeNum = 9007199254740992; // 2^53

Number.isInteger(unsafeNum);      // true (数学意义上它确实没有小数位)
Number.isSafeInteger(unsafeNum);  // false (超出安全区间，不再可信)

// 精度丢失灾难演示
unsafeNum + 1 === unsafeNum;      // true！(运算已经失真)

五、实际业务场景中的校验模式与选型指南

在真实的工程项目中，仅仅依靠一个 Number.isInteger() 往往不能涵盖所有业务需求。以下总结了三种最为常见的业务校验场景及其标准实现模式。

场景 1：表单与 URL 查询参数（字符串形式的整数）

来自 URL ?page=2 或表单输入框的字段在 JavaScript 中获取时通常是 string 类型。由于 Number.isInteger("2") 会直接返回 false，我们需要先验证字符串格式，再进行安全转换：

/**
 * 校验字符串是否为合法的整数形式（支持正负号）
 * @param {string} str 
 * @returns {boolean}
 */
function isIntegerString(str) {
  if (typeof str !== 'string') return false;
  const trimmed = str.trim();
  // 1. 正则排查非整数格式（防止 "1.0" 或科学计数法混入）
  if (!/^-?\d+$/.test(trimmed)) return false;
  // 2. 安全数值边界校验
  const num = Number(trimmed);
  return Number.isSafeInteger(num);
}

// 验证测试
isIntegerString("42");    // true
isIntegerString("-10");   // true
isIntegerString("3.14");  // false
isIntegerString("");      // false
isIntegerString("abc");   // false

场景 2：接口分页参数（正整数校验）

在 API 路由处理或控制器层，分页参数 page 和 pageSize 必须严格为大于 0 的正整数：

/**
 * 校验值是否为合法的正整数（如分页页码）
 * @param {unknown} value 
 * @returns {boolean}
 */
function isPositiveInteger(value) {
  return Number.isInteger(value) && value > 0;
}

isPositiveInteger(1);    // true
isPositiveInteger(0);    // false (页码从 1 开始)
isPositiveInteger(-5);   // false
isPositiveInteger(2.5);  // false

六、核心要点总结

综上所述，在现代 JavaScript 开发中处理整数判定时，请牢记以下实践准则：

• 优先使用原生方法：对于已处于 number 类型的变量，始终优先使用 Number.isInteger()，避免手写 % 1 === 0 等易混淆的传统方法。
• 区分类型上下文：若输入来自表单、URL 或未解析的文本，先通过正则表达式验证数字形态，再进行类型转换与安全范围检测。
• 警惕大数精度：当数值可能超过 9007199254740991（如 64 位雪花算法 ID）时，使用 Number.isSafeInteger() 进行守护，或者直接使用原生 BigInt 存储。