JavaScript / TypeScript / 系统课时

静态成员与类类型

静态成员与类类型

TypeScript 中一个类同时存在实例侧和静态侧:实例保存普通属性与方法,类本身保存静态成员和构造能力。理解这两侧的类型差异,才能正确使用 static、类名类型以及 typeof 类名。

学习目标

  • 区分实例成员与静态成员的访问方式
  • 理解类名作为类型时表示实例类型
  • 使用 typeof 类名 表示构造函数及静态侧类型

实例侧与静态侧

没有 static 的成员属于实例,必须先通过 new 创建对象才能访问。带有 static 的成员直接属于类本身,不需要实例,并且不同实例共享同一份静态状态。

ts
class Counter {
  static total = 0;
  readonly id: number;

  constructor() {
    // 静态计数属于类本身,所有实例共同修改它
    Counter.total += 1;
    this.id = Counter.total;
  }

  label(): string {
    return `counter-${this.id}`;
  }
}

const first = new Counter();
const second = new Counter();

console.log(first.label());
console.log(second.label());
console.log(Counter.total);

预期输出

text
counter-1
counter-2
2

id 和 label 存在于每个 Counter 实例上,而 total 通过 Counter.total 访问。不能写 first.total,因为实例类型中并不存在这个静态成员。

一个类对应两种类型视角

类声明后,类名在不同位置承担不同角色。在类型位置写 Counter,得到的是实例侧类型;在值位置写 Counter,得到的是实际构造函数对象。若需要描述这个构造函数对象的类型,可以写 typeof Counter。

类的实例侧与静态侧类型关系

这种双重身份是理解类类型的关键。User 并不是“类对象本身的类型”,而是 new User(...) 产生的实例所具有的类型。

使用类名和 typeof 类名

下面分别编写接收实例和接收类本身的函数。printUser 的参数类型是 User,因此只能使用实例成员;createUser 接收 typeof User,因此可以调用类的静态方法和构造函数。

ts
class User {
  static category = "member";

  constructor(public name: string) {}

  greet(): string {
    return `Hello, ${this.name}`;
  }

  static create(name: string): User {
    return new User(name);
  }
}

function printUser(user: User): void {
  // User 在类型位置表示实例侧
  console.log(user.greet());
}

function createUser(userClass: typeof User, name: string): User {
  // typeof User 包含静态方法和构造能力
  console.log(userClass.category);
  return userClass.create(name);
}

const user = createUser(User, "Ada");
printUser(user);

预期输出

text
member
Hello, Ada

如果把 createUser 的第一个参数声明成 User,传入类本身 User 就会类型不匹配,因为一个实例并不具备静态成员 category、create 和构造能力。

只约束构造能力

有时函数并不关心某个具体类的全部静态成员,只要求传入的值能够用 new 创建指定结构的实例。这时可以直接声明构造签名,而不是绑定到 typeof 某个具体类。

ts
interface Named {
  name: string;
}

type NamedConstructor = new (name: string) => Named;

class Customer {
  constructor(public name: string) {}
}

function build(ctor: NamedConstructor, name: string): Named {
  return new ctor(name);
}

const customer = build(Customer, "Grace");
console.log(customer.name);

预期输出

text
Grace

typeof User 适合要求“与这个具体类的静态侧兼容”,构造签名则适合要求“任何能够创建目标实例的类”。区分实例侧、静态侧和构造能力后,类作为函数参数、工厂对象或依赖注入入口时就不会混淆类型。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

静态成员与类类型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通