JavaScript / TypeScript / 系统课时
静态成员与类类型
静态成员与类类型
TypeScript 中一个类同时存在实例侧和静态侧:实例保存普通属性与方法,类本身保存静态成员和构造能力。理解这两侧的类型差异,才能正确使用 static、类名类型以及 typeof 类名。
学习目标
- 区分实例成员与静态成员的访问方式
- 理解类名作为类型时表示实例类型
- 使用
typeof 类名表示构造函数及静态侧类型
实例侧与静态侧
没有 static 的成员属于实例,必须先通过 new 创建对象才能访问。带有 static 的成员直接属于类本身,不需要实例,并且不同实例共享同一份静态状态。
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);预期输出
counter-1
counter-2
2id 和 label 存在于每个 Counter 实例上,而 total 通过 Counter.total 访问。不能写 first.total,因为实例类型中并不存在这个静态成员。
一个类对应两种类型视角
类声明后,类名在不同位置承担不同角色。在类型位置写 Counter,得到的是实例侧类型;在值位置写 Counter,得到的是实际构造函数对象。若需要描述这个构造函数对象的类型,可以写 typeof Counter。

这种双重身份是理解类类型的关键。User 并不是“类对象本身的类型”,而是 new User(...) 产生的实例所具有的类型。
使用类名和 typeof 类名
下面分别编写接收实例和接收类本身的函数。printUser 的参数类型是 User,因此只能使用实例成员;createUser 接收 typeof User,因此可以调用类的静态方法和构造函数。
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);预期输出
member
Hello, Ada如果把 createUser 的第一个参数声明成 User,传入类本身 User 就会类型不匹配,因为一个实例并不具备静态成员 category、create 和构造能力。
只约束构造能力
有时函数并不关心某个具体类的全部静态成员,只要求传入的值能够用 new 创建指定结构的实例。这时可以直接声明构造签名,而不是绑定到 typeof 某个具体类。
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);预期输出
Gracetypeof User 适合要求“与这个具体类的静态侧兼容”,构造签名则适合要求“任何能够创建目标实例的类”。区分实例侧、静态侧和构造能力后,类作为函数参数、工厂对象或依赖注入入口时就不会混淆类型。