JavaScript / TypeScript / 系统课时

使用元组

使用元组

本课解决“数组中每个位置含义不同”的类型建模问题。你将用元组固定元素顺序与长度,并掌握可选元素、剩余元素和只读元组的适用边界。

学习目标

  • 使用元组为固定位置声明不同类型
  • 使用可选元素和剩余元素表达可变长度结构
  • 使用只读元组保护返回值和常量数据

声明基础元组

元组使用方括号依次写出每个位置的类型。与普通数组相比,它不仅限制元素类型,还限制位置和长度,适合坐标、键值对、函数多返回值等结构。

可以给元组元素添加标签,例如 [id: number, name: string]。标签只改善编辑器提示,不会改变运行时数据,也不会生成对象字段。

可选元素与剩余元素

可选元素在类型后加 ?,并且必须位于所有必选元素之后。读取可选位置时,结果类型会包含 undefined,因此应提供默认值或先判断再使用。

元组末尾还可以使用 ...T[] 接收数量不定但类型一致的剩余元素。它适合“固定头部加可变尾部”的结构,例如命令名后跟任意数量的字符串参数。

只读元组

只读元组写作 readonly [T1, T2]。它保留固定位置的精确类型,同时禁止索引赋值和改变长度的方法。常量表达式配合 as const 时,TypeScript 会推断出只读字面量元组。

只读取元组的函数参数应优先声明为只读形式,因为它既能接收普通元组,也能接收只读元组。

完整示例

下面的示例覆盖基础元组、可选元素、剩余元素和只读元组。保存为 tuple-demo.ts 后运行。

ts
type UserEntry = [id: number, name: string, active: boolean];
type HttpResult = [status: number, body: string, requestId?: string];
type Command = [name: string, ...args: string[]];

function printResult([status, body, requestId = "none"]: HttpResult): void {
  console.log(`${status} | ${body} | ${requestId}`);
}

function formatCommand([name, ...args]: Command): string {
  return [name, ...args].join(" ");
}

function distanceFromOrigin([x, y]: readonly [number, number]): number {
  // 参数只读,函数不能修改调用方的坐标
  return Math.sqrt(x * x + y * y);
}

const user: UserEntry = [101, "Ada", true];
const point = [120, 30] as const;

console.log(user.join(" | "));
printResult([200, "OK", "req-001"]);
printResult([304, "Not Modified"]);
console.log(formatCommand(["build", "--mode", "production"]));
console.log(distanceFromOrigin(point).toFixed(2));

运行命令:

bash
npx tsx tuple-demo.ts

预期输出:

text
101 | Ada | true
200 | OK | req-001
304 | Not Modified | none
build --mode production
123.69

实际文件路径可能不同,但输出顺序和内容应与示例一致。

元组、数组与对象的选择

当长度、顺序和每个位置的含义都稳定时使用元组;当元素数量变化较大且每项含义相同,使用数组;当字段较多、经常扩展或调用处需要清楚表达字段名称,使用对象。

元组不适合承载复杂业务实体。位置一旦过多,调用者很难仅凭顺序理解含义,此时对象通常更易读、更易扩展。

本课总结

  • 元组同时约束元素类型、位置和长度
  • 可选元素适合少量尾部信息,剩余元素适合固定头部加同类型尾部
  • 只读元组能保护固定结构,并适合函数返回值与常量数据

下一课预告

下一课将继续整理对象类型的声明方式,学习如何描述属性、可选字段和只读字段。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用元组

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

登录哪都通