JavaScript / TypeScript / 系统课时
声明类成员
声明类成员
类成员声明决定了对象能保存什么数据、暴露什么行为,以及字段在何时完成初始化。本课通过一个可运行示例,掌握实例属性、方法、构造函数参数属性与严格字段初始化检查,最终能够写出类型明确且可安全创建的 TypeScript 类。
学习目标
- 为实例属性、方法参数和返回值添加准确类型
- 使用构造函数参数属性减少重复声明
- 正确处理
strictPropertyInitialization检查
类成员的基本写法
类中最常见的成员是实例属性、方法和构造函数。属性描述每个实例保存的数据,方法描述实例可以执行的行为,构造函数负责接收创建对象时所需的初始值。
class BankAccount {
owner: string;
balance: number = 0;
constructor(owner: string, initialBalance: number) {
this.owner = owner;
this.balance = initialBalance;
}
deposit(amount: number): number {
if (amount <= 0) {
throw new Error("存款金额必须大于 0");
}
this.balance += amount;
return this.balance;
}
}
const account = new BankAccount("Alice", 100);
console.log(account.deposit(50));
console.log(account.balance);运行方式:
npx tsc account.ts --target ES2022 --strict && node account.js预期输出:
150
150owner 在构造函数中赋值,balance 通过字段初始化器获得默认值。deposit 明确声明参数为 number,并将返回值也声明为 number,调用者因此可以直接获知方法契约。
使用构造函数参数属性
当构造函数参数只是为了保存到同名实例属性时,可以在参数前添加 public、protected、private 或 readonly。TypeScript 会同时完成参数声明、属性声明和赋值。
class Product {
constructor(
public readonly id: string,
public name: string,
private price: number
) {}
getPrice(): number {
return this.price;
}
}
const product = new Product("P-1001", "Mechanical Keyboard", 399);
console.log(product.id, product.name, product.getPrice());运行方式:
npx tsc product.ts --target ES2022 --strict && node product.js预期输出:
P-1001 Mechanical Keyboard 399参数属性适合简单的数据承载类,但参数过多时会降低构造函数可读性。此时可以改用配置对象,并为配置对象单独声明接口。
处理字段初始化检查
启用 strict 后,TypeScript 会检查非可选实例字段是否在声明处或构造函数中完成初始化。以下写法会报错,因为 token 可能在实例创建后仍未赋值。
class Session {
token: string;
}预期结果:
TS2564: Property 'token' has no initializer and is not definitely assigned in the constructor.处理方式应按字段语义选择:
- 创建实例时必须有值:通过构造函数赋值。
- 字段有自然默认值:使用字段初始化器。
- 字段允许不存在:声明为
token?: string或token: string | undefined。 - 字段由框架稍后注入:可使用确定赋值断言
token!: string,但必须保证运行前确实完成注入。
class Session {
createdAt: Date = new Date();
token?: string;
constructor(public readonly userId: string) {}
attachToken(token: string): void {
this.token = token;
}
}
const session = new Session("U-1001");
session.attachToken("T-2001");
console.log(session.userId, session.token);
console.log(session.createdAt instanceof Date);运行方式:
npx tsc session.ts --target ES2022 --strict && node session.js预期输出:
U-1001 T-2001
true这个版本通过真实初始化和可选类型消除了字段检查错误。确定赋值断言会跳过编译器检查,因此不应把 ! 当作默认解决方案。
方法签名与成员边界
方法参数通常应显式标注类型;公共方法的返回值也建议显式声明,以防实现修改后意外改变对外契约。只有在返回类型非常直观且方法仅供类内部使用时,才可以依赖类型推断。
实例属性属于每个对象;若数据属于类本身,应使用 static。例如计数器、工厂方法或固定配置可以声明为静态成员,但不要把会随实例变化的状态错误地放到静态属性中。
常见错误
不要只声明字段却忘记在构造函数中赋值,也不要用 ! 掩盖真实的未初始化风险。构造函数参数属性已经创建了同名字段,无需再写一次属性声明,否则会形成重复标识符。
readonly 只限制属性在初始化后重新赋值,不会自动把引用对象变成深度只读。若属性指向数组或对象,内部内容仍可能被修改。
本课总结
- 类成员应同时表达数据类型、方法契约和初始化时机
- 构造函数参数属性可以合并参数、字段声明与赋值
- 字段初始化错误应优先通过真实初始化或可选类型解决
下一课预告
下一课将使用 public、protected、private 和 ECMAScript 私有字段控制成员可见范围,并比较编译期限制与运行时私有性的区别。