Number.isSafeInteger用于校验已为number类型的值是否为安全整数，即类型为number、是整数、且在−9007199254740991至9007199254740991范围内，专用于防范浮点精度导致的静默错误。
Number.isSafeInteger 本身不是通用数据验证器，它只在“值已是 number 类型”且需确认“是否可精确参与整数运算”时才起关键作用。它不处理类型转换、不清理输入、不替代业务规则，但能在数值进入关键逻辑前，快速拦截因 JS 浮点精度导致的静默错误。
专用于安全整数终态校验
它只对已完成转型的 number 值做三重确认：类型是 number、值是整数、数值落在 −9007199254740991 到 9007199254740991 范围内。例如：
-
ID 字段解析后：后端返回 JSON 中的
"id": 9007199254740992，JS 解析为 number，但该值已超出安全范围 →Number.isSafeInteger(id)返回 false，提示需改用字符串或 BigInt 处理 -
分页偏移计算后：执行
offset = page * pageSize后，必须立即校验Number.isSafeInteger(offset)，否则后续数组索引或 API 参数可能出错 -
金额或计数器递增后：如
counter = prev + 1，不能只校验prev，必须校验结果，因为两个安全整数相加也可能越界
不能替代输入预处理
传入字符串、null、空格、科学计数法字符串等，它一律返回 false —— 这不是校验失败，而是类型不匹配。真实场景中必须前置处理：
- 对用户输入的字符串，先用
/^-?\d+$/.test(input.trim())排除非数字格式，再用Number(input)转型 - 避免用
parseInt(input, 10)：它会截断"123abc"成 123，掩盖原始非法输入 - 对极大数字字符串（如 20 位 ID），正则限制长度
/^\d{1,16}$/比转型后再判更可靠，防止 JS 自动转成科学计数法失真
与后端协同的校验定位
它属于前端轻量级“精度守门员”，作用明确但边界清晰：
立即学习“Java免费学习笔记（深入）”；
- ✅ 它能提前发现
9007199254740992 === 9007199254740993这类精度陷阱，避免请求发出去再被后端拒绝 - ❌ 它不保证数据库字段能存下：MySQL 的 INT(11) 最大仅 2147483647，而 JS 安全上限约 9e15，二者需对齐或约定（如统一用 BIGINT）
- ❌ 它不处理业务语义：正数 ID、非零金额、有效页码等，仍需额外判断，例如
Number.isSafeInteger(id) && id > 0
典型误用与正确组合
单独调用 Number.isSafeInteger(value) 很少够用。实用校验应是链式判断：
- 字符串输入：
typeof input === 'string' && /^\d+$/.test(input) && Number.isSafeInteger(Number(input)) - API 响应数值：
typeof data.id === 'number' && Number.isSafeInteger(data.id)（JSON 解析后立刻执行） - 运算中间值：
const result = a * b; if (!Number.isSafeInteger(result)) throw new Error('计算结果超出安全整数范围')
