JS/TS中兼顾性能的整数输入强制校验最优方案

问题背景 #

我并非JS/TS母语开发者，目前编写了一个仅能接受整数输入的数学函数，若输入非整数会导致崩溃，因此必须对输入进行强制校验。（注：若此问题重复，我深表歉意，但未找到相关答案。）

我的首次尝试实现如下：

function math(a) {
    if(a % 1 != 0) return NaN;
    // to mathy stuff
    return b;
}

但由于该函数会被频繁调用，我希望找到性能损耗更小的方案。经搜索后，我发现了原生函数方案：

function math(a) {
    if(!Number.isInteger(a)) return NaN;
    // to mathy stuff
    return b;
}

不过两种方案的性能差异不大。接下来我考虑使用BigInt作为输入（至少可通过TypeScript在编译时强制）：

let num: number = 0;
let c: BigInt = math(BigInt(num));

function math(a: bigint) {
    // to mathy stuff
    return b;
}

但这种方式需要显式将number转换为BigInt，且可能存在诸多问题。

请问兼顾性能的整数输入强制校验最优方案是什么？我可接受TypeScript编译时方案，但更偏好JavaScript运行时方案。

最优方案推荐 #

1. 纯JS运行时：typeof前置过滤 + Number.isInteger()组合

优先选用这个方案，兼顾性能、可读性和边界场景处理：

function math(a) {
    // 快速过滤非数字类型，减少后续校验的无效执行
    if (typeof a !== 'number') return NaN;
    // 原生API精准判断整数，底层为优化过的原生实现
    if (!Number.isInteger(a)) return NaN;
    // 执行数学逻辑
    return b;
}

• 相比单独用a % 1 !== 0，Number.isInteger()语义更清晰，对NaN、Infinity等特殊值的处理更符合直觉，且高频调用下性能不弱于模运算，部分JS引擎中表现更优。
• 前置typeof判断可以快速排除字符串、对象等非数字输入，减少进入整数校验逻辑的次数，进一步提升性能。

2. TS环境：编译时类型约束 + 轻量运行时校验

如果用TypeScript，结合编译时类型检查和运行时轻量校验，既在开发阶段提前拦截错误输入，又保证运行时健壮性：

function math(a: number): number {
    // 保留运行时校验，避免绕过TS编译的外部调用场景
    if (!Number.isInteger(a)) return NaN;
    // 执行数学逻辑
    return b;
}

这种方式不需要强制使用BigInt，保留了number类型的便捷性，同时通过TS类型系统在编译时限制输入为number类型，兼顾开发效率和运行时性能。

3. BigInt方案的适用边界

BigInt仅适合处理超出Number.MAX_SAFE_INTEGER（2^53 - 1）的超大整数场景。如果你的函数不需要处理这类数值，不建议使用——它需要显式转换，运算性能不如普通number，还会增加代码复杂度，不符合“兼顾性能”的需求。

总结 #

• 纯JS环境：typeof a !== 'number' + Number.isInteger()的组合是最优解
• TS环境：编译时类型约束a: number + 运行时Number.isInteger()校验，兼顾类型安全与运行时健壮性

内容的提问来源于stack exchange，提问作者pqzpkaot