JavaScript / TypeScript / 系统课时

声明类成员

声明类成员

类成员声明决定了对象能保存什么数据、暴露什么行为,以及字段在何时完成初始化。本课通过一个可运行示例,掌握实例属性、方法、构造函数参数属性与严格字段初始化检查,最终能够写出类型明确且可安全创建的 TypeScript 类。

学习目标

  • 为实例属性、方法参数和返回值添加准确类型
  • 使用构造函数参数属性减少重复声明
  • 正确处理 strictPropertyInitialization 检查

类成员的基本写法

类中最常见的成员是实例属性、方法和构造函数。属性描述每个实例保存的数据,方法描述实例可以执行的行为,构造函数负责接收创建对象时所需的初始值。

ts
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);

运行方式:

bash
npx tsc account.ts --target ES2022 --strict && node account.js

预期输出:

text
150
150

owner 在构造函数中赋值,balance 通过字段初始化器获得默认值。deposit 明确声明参数为 number,并将返回值也声明为 number,调用者因此可以直接获知方法契约。

使用构造函数参数属性

当构造函数参数只是为了保存到同名实例属性时,可以在参数前添加 public、protected、private 或 readonly。TypeScript 会同时完成参数声明、属性声明和赋值。

ts
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());

运行方式:

bash
npx tsc product.ts --target ES2022 --strict && node product.js

预期输出:

text
P-1001 Mechanical Keyboard 399

参数属性适合简单的数据承载类,但参数过多时会降低构造函数可读性。此时可以改用配置对象,并为配置对象单独声明接口。

处理字段初始化检查

启用 strict 后,TypeScript 会检查非可选实例字段是否在声明处或构造函数中完成初始化。以下写法会报错,因为 token 可能在实例创建后仍未赋值。

ts
class Session {
  token: string;
}

预期结果:

text
TS2564: Property 'token' has no initializer and is not definitely assigned in the constructor.

处理方式应按字段语义选择:

  • 创建实例时必须有值:通过构造函数赋值。
  • 字段有自然默认值:使用字段初始化器。
  • 字段允许不存在:声明为 token?: string 或 token: string | undefined。
  • 字段由框架稍后注入:可使用确定赋值断言 token!: string,但必须保证运行前确实完成注入。
ts
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);

运行方式:

bash
npx tsc session.ts --target ES2022 --strict && node session.js

预期输出:

text
U-1001 T-2001
true

这个版本通过真实初始化和可选类型消除了字段检查错误。确定赋值断言会跳过编译器检查,因此不应把 ! 当作默认解决方案。

方法签名与成员边界

方法参数通常应显式标注类型;公共方法的返回值也建议显式声明,以防实现修改后意外改变对外契约。只有在返回类型非常直观且方法仅供类内部使用时,才可以依赖类型推断。

实例属性属于每个对象;若数据属于类本身,应使用 static。例如计数器、工厂方法或固定配置可以声明为静态成员,但不要把会随实例变化的状态错误地放到静态属性中。

常见错误

不要只声明字段却忘记在构造函数中赋值,也不要用 ! 掩盖真实的未初始化风险。构造函数参数属性已经创建了同名字段,无需再写一次属性声明,否则会形成重复标识符。

readonly 只限制属性在初始化后重新赋值,不会自动把引用对象变成深度只读。若属性指向数组或对象,内部内容仍可能被修改。

本课总结

  • 类成员应同时表达数据类型、方法契约和初始化时机
  • 构造函数参数属性可以合并参数、字段声明与赋值
  • 字段初始化错误应优先通过真实初始化或可选类型解决

下一课预告

下一课将使用 public、protected、private 和 ECMAScript 私有字段控制成员可见范围,并比较编译期限制与运行时私有性的区别。

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

目录与阅读设置

阅读设置

17

记录一个想法

声明类成员

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

登录哪都通