JavaScript / TypeScript / 系统课时
使用元组
使用元组
本课解决“数组中每个位置含义不同”的类型建模问题。你将用元组固定元素顺序与长度,并掌握可选元素、剩余元素和只读元组的适用边界。
学习目标
- 使用元组为固定位置声明不同类型
- 使用可选元素和剩余元素表达可变长度结构
- 使用只读元组保护返回值和常量数据
声明基础元组
元组使用方括号依次写出每个位置的类型。与普通数组相比,它不仅限制元素类型,还限制位置和长度,适合坐标、键值对、函数多返回值等结构。
可以给元组元素添加标签,例如 [id: number, name: string]。标签只改善编辑器提示,不会改变运行时数据,也不会生成对象字段。
可选元素与剩余元素
可选元素在类型后加 ?,并且必须位于所有必选元素之后。读取可选位置时,结果类型会包含 undefined,因此应提供默认值或先判断再使用。
元组末尾还可以使用 ...T[] 接收数量不定但类型一致的剩余元素。它适合“固定头部加可变尾部”的结构,例如命令名后跟任意数量的字符串参数。
只读元组
只读元组写作 readonly [T1, T2]。它保留固定位置的精确类型,同时禁止索引赋值和改变长度的方法。常量表达式配合 as const 时,TypeScript 会推断出只读字面量元组。
只读取元组的函数参数应优先声明为只读形式,因为它既能接收普通元组,也能接收只读元组。
完整示例
下面的示例覆盖基础元组、可选元素、剩余元素和只读元组。保存为 tuple-demo.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));运行命令:
npx tsx tuple-demo.ts预期输出:
101 | Ada | true
200 | OK | req-001
304 | Not Modified | none
build --mode production
123.69实际文件路径可能不同,但输出顺序和内容应与示例一致。
元组、数组与对象的选择
当长度、顺序和每个位置的含义都稳定时使用元组;当元素数量变化较大且每项含义相同,使用数组;当字段较多、经常扩展或调用处需要清楚表达字段名称,使用对象。
元组不适合承载复杂业务实体。位置一旦过多,调用者很难仅凭顺序理解含义,此时对象通常更易读、更易扩展。
本课总结
- 元组同时约束元素类型、位置和长度
- 可选元素适合少量尾部信息,剩余元素适合固定头部加同类型尾部
- 只读元组能保护固定结构,并适合函数返回值与常量数据
下一课预告
下一课将继续整理对象类型的声明方式,学习如何描述属性、可选字段和只读字段。