TypeScript中使用instanceof检查接口类型报错的解决方案咨询

问题分析 #

这个坑我之前踩过！核心原因很简单：TypeScript的接口是纯编译时类型，编译成JavaScript后就会被完全擦除，而instanceof是运行时的检查逻辑，这时根本找不到BookModel这个“值”，所以才会报错。

下面给你几个实用的解决思路，按需选择：

方案1：把接口改成类（最直接） #

如果你的BookModel本来就需要被实例化，直接把接口换成类就行——类在编译后会保留对应的构造函数，instanceof就能正常工作：

export class BookModel { 
  constructor(
    public id: number, 
    public title: string, 
    public publishedAt: Date
  ) {}
}

// 使用方式调整为类实例化
let book = new BookModel(1, "Title", new Date(2018, 10, 12));

// validate方法里正常用instanceof
validate(requirement: Requirement, resource: any) : boolean {
  if (resource instanceof BookModel) {
    // 这里TypeScript会自动推断resource为BookModel类型
    console.log(resource.title);
    // 你的校验逻辑...
    return true;
  }
  if (resource instanceof PostModel) {
    // 处理PostModel逻辑
  }
  return false;
}

方案2：自定义类型守卫（适合纯数据对象） #

如果BookModel只是用来描述数据结构（比如API返回的对象），不想改成类，可以给接口加一个类型标签，再写个自定义类型守卫函数：

// 给每个接口加唯一的类型标识
export interface BookModel { 
  id: number; 
  title: string; 
  publishedAt: Date;
  type: 'book'; // 新增类型标签
}

export interface PostModel {
  id: number;
  content: string;
  type: 'post';
}

// 自定义类型守卫，告诉TypeScript怎么判断类型
function isBookModel(resource: any): resource is BookModel {
  return resource?.type === 'book';
}

function isPostModel(resource: any): resource is PostModel {
  return resource?.type === 'post';
}

// validate方法里用类型守卫替代instanceof
validate(requirement: Requirement, resource: any) : boolean {
  if (isBookModel(resource)) {
    // 这里resource会被自动推断为BookModel类型
    console.log(resource.publishedAt);
  }
  if (isPostModel(resource)) {
    console.log(resource.content);
  }
  return false;
}

这个方案的好处是不用改变数据的创建方式（比如不用new，直接字面量赋值也能正常工作），而且编译后type属性会保留，运行时能正确识别。

方案3：检查关键属性（适合简单场景） #

如果不想加类型标签，也可以直接检查对象是否包含目标类型的关键属性，配合类型断言使用：

validate(requirement: Requirement, resource: any) : boolean {
  // 检查BookModel的核心属性是否存在且类型正确
  if (resource 
      && typeof resource.id === 'number' 
      && typeof resource.title === 'string' 
      && resource.publishedAt instanceof Date) {
    // 手动断言为BookModel
    const book = resource as BookModel;
    // 执行校验逻辑...
  }
  // 同理检查PostModel的属性
  return false;
}

这个方法比较繁琐，属性多的时候容易漏检，适合结构简单的类型。

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