JavaScript / TypeScript / 系统课时

声明对象结构

声明对象结构

对象类型用于规定一个对象必须有哪些属性、每个属性保存什么类型的数据,以及哪些字段可以缺省或禁止修改。本课将通过可运行示例,掌握内联对象类型、可选属性和只读属性的常用写法。

学习目标

  • 使用对象类型约束属性名称和值类型
  • 用可选属性表达“可能不存在”的字段
  • 用只读属性保护初始化后不应修改的数据

定义对象类型

可以直接在变量后写出对象结构。属性之间可用分号或换行分隔,属性名称和类型必须与实际对象一致。

ts
const product: {
  id: number;
  name: string;
  price: number;
} = {
  id: 1001,
  name: "TypeScript 手册",
  price: 49
};

console.log(`${product.id} - ${product.name} - ${product.price}`);

预期输出

text
1001 - TypeScript 手册 - 49

当对象结构会被多处复用时,应提取为 type 或 interface。这样可以减少重复,并让函数参数、返回值和变量共享同一套约束。

使用可选属性

在属性名后添加 ?,表示该属性可以存在,也可以省略。读取可选属性时,结果类型会自动包含 undefined,因此应先判断或提供默认值。

ts
type UserProfile = {
  id: number;
  nickname: string;
  email?: string;
};

function formatEmail(user: UserProfile): string {
  return user.email ?? "未填写邮箱";
}

const alice: UserProfile = {
  id: 1,
  nickname: "Alice"
};

console.log(formatEmail(alice));

预期输出

text
未填写邮箱

可选属性适合补充资料、非必填配置和接口中的条件字段。不要为了绕过类型检查而把所有字段都标记为可选,否则对象约束会失去意义。

使用只读属性

在属性名前添加 readonly,表示该属性只能在对象创建时赋值,之后不能通过当前引用重新赋值。它适合主键、订单号和创建时间等身份类字段。

ts
type Order = {
  readonly orderNo: string;
  amount: number;
  remark?: string;
};

const order: Order = {
  orderNo: "ORD-20260802-001",
  amount: 99
};

order.amount = 109;
console.log(`${order.orderNo}: ${order.amount}`);

预期输出

text
ORD-20260802-001: 109

如果执行 order.orderNo = "NEW",TypeScript 会在编译阶段报错。readonly 只限制属性重新赋值,并不会自动把嵌套对象变成深度只读。

处理额外属性与结构兼容

TypeScript 采用结构类型系统:只要对象至少包含目标类型要求的属性,就可以在多数场景中兼容。不过,将对象字面量直接赋给目标类型时,会进行额外属性检查。

ts
type Point = {
  x: number;
  y: number;
};

const source = { x: 10, y: 20, label: "起点" };
const point: Point = source;

console.log(point.x + point.y);

预期输出

text
30

直接写成 const point: Point = { x: 10, y: 20, label: "起点" } 会因 label 不在 Point 中而报错。业务模型若确实允许动态键,应使用索引签名或更明确的扩展类型,而不是随意使用 any。

本课总结

  • 对象类型同时约束属性名称、必填性和值类型
  • ? 表示属性可缺省,读取时需要处理 undefined
  • readonly 保护属性不被重新赋值,但不是深度不可变

下一课预告

下一课将学习联合类型与交叉类型,分别表达“多种可能值”和“同时满足多组结构”的类型关系。

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

目录与阅读设置

阅读设置

17

记录一个想法

声明对象结构

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

登录哪都通