JS函数类型检查与运行时验证方法

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《JS函数类型检查定义与运行时验证方法》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

函数类型检查是在调用前验证参数类型是否符合预期，JavaScript作为动态语言需通过typeof、Array.isArray、instanceof和Object.prototype.toString.call等方法在运行时进行类型判断，可封装assertType工具函数复用逻辑，推荐结合TypeScript在编译期捕获错误，提升代码健壮性。

JavaScript 是一门动态类型语言，函数参数的类型在运行时才确定。虽然 ES6 以后引入了默认参数和解构，但原生并不支持类型声明。因此，要实现函数类型的检查，需要通过手动编码或借助工具进行运行时验证。

1. 什么是函数类型检查

函数类型检查指的是在调用函数前，验证传入参数的类型是否符合预期。例如，某个函数期望接收一个字符串和一个数字，若传入的是对象或数组，可能导致运行错误。通过类型检查，可以在出错前抛出明确提示，提升代码健壮性。

由于 JS 不像 TypeScript 那样支持静态类型标注，这类检查通常在运行时完成。

2. 常见的运行时类型检查方法

以下是几种实用的类型验证方式：

• 使用 typeof 检查基础类型

typeof 适用于判断 string、number、boolean、function、undefined 等原始类型。

示例：

function greet(name) {
  if (typeof name !== 'string') {
    throw new TypeError('name 必须是字符串');
  }
  return `Hello, ${name}`;
}

• 使用 Array.isArray() 判断数组

typeof 对数组返回 "object"，不可靠。应使用 Array.isArray()。

示例：

function sum(numbers) {
  if (!Array.isArray(numbers)) {
    throw new TypeError('numbers 必须是数组');
  }
  return numbers.reduce((a, b) => a + b, 0);
}

• 使用 instanceof 或 constructor 判断对象类型

对于自定义类或内置对象（如 Date、RegExp），可用 instanceof。

示例：

function formatDate(date) {
  if (!(date instanceof Date)) {
    throw new TypeError('date 必须是 Date 类型');
  }
  return date.toISOString().split('T')[0];
}

• 使用 Object.prototype.toString.call() 进行精确类型识别

这是最可靠的通用类型判断方法，可识别 null、数组、日期等。

示例：

function getType(value) {
  return Object.prototype.toString.call(value).slice(8, -1).toLowerCase();
}
function processInput(input) {
const type = getType(input);
if (type !== 'string' && type !== 'number') {
throw new TypeError('input 必须是字符串或数字');
}
// 处理逻辑
}

3. 封装类型检查工具函数

为避免重复代码，可封装一个类型断言函数：

function assertType(value, expectedType, paramName) {
  const type = Object.prototype.toString.call(value).slice(8, -1).toLowerCase();
  if (type !== expectedType.toLowerCase()) {
    throw new TypeError(`${paramName} 必须是 ${expectedType} 类型，收到: ${type}`);
  }
}
// 使用示例
function createUser(name, age) {
assertType(name, 'string', 'name');
assertType(age, 'number', 'age');
return { name, age };
}

4. 使用 TypeScript 实现编译期类型检查

若项目允许，推荐使用 TypeScript 在开发阶段捕获类型错误。

示例：

function multiply(a: number, b: number): number {
  return a * b;
}

TypeScript 编译时会检查参数类型，但最终生成的 JS 仍无类型限制。因此生产环境建议结合运行时检查。

基本上就这些。JS 函数的类型检查依赖开发者主动验证，合理使用 typeof、Array.isArray、instanceof 和 toString 方法，能有效防止类型错误。配合工具函数或 TypeScript，可大幅提升代码可靠性。不复杂但容易忽略。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~