TypeScript7(元组)

在 TypeScript 中,元组(Tuple)是一种特殊的数组类型,它允许你明确地定义数组中每个元素的类型和数量。与普通数组不同,元组的长度是固定的,并且每个位置的类型都是预先确定的。

当你需要一个固定长度、且元素类型不完全相同的数组时,元组是比普通数组更具表达力和类型安全的选择。

1.元组的写法

元组的写法非常直观,你只需要在类型注解中使用方括号 [],并在其中列出每个元素的类型。

ts 复制代码
let person: [string, number];

赋值时,必须遵守定义的类型和顺序。

ts 复制代码
person = ["Alice", 25];
// console.log(person);// ["Alice", 25]

2.为什么使用元组?

元组的核心优势在于它提供了比数组更强的类型安全和结构化 ,它将数组的索引与元素的含义关联起来,让代码的意图更加清晰。
可以使用?来定义元组中的可选元素,但必须放在元组类型定义中的末尾

ts 复制代码
let optionalTuple: [string, number, boolean?]
optionalTuple = ["Alice", 25];
optionalTuple = ["Alice", 25, true];
// console.log(optionalTuple);// ["Alice", 25, true]

可以使用...type[]来定义元组的剩余元素,也必须放在元组类型定义中的末尾

ts 复制代码
let restTuple: [string, ...number[]]
restTuple = ['Alice'];
restTuple = ['Alice', 25, 30, 35];
// console.log(restTuple);// ["Alice", 25, 30, 35]

3.使用场景

栗子1:函数返回多个值

当你需要从一个函数返回多个、不同类型的值时,元组是很好的选择。例如,一个函数可能需要返回一个状态码(数字)和一条描述信息(字符串)。

ts 复制代码
const getStatus = (): [number, string] => {
    return [200, "OK"];
}

const [statusCode, message] = getStatus();
// console.log(statusCode, message);// 200 OK

栗子2:定义键值对

元组非常适合用来表示简单的键值对,例如 key, value。当你从一个 Map 或其他数据结构中迭代出键值对时,元组的结构非常清晰。

ts 复制代码
const userMap = new Map<string, number>();
userMap.set("Alice", 25);
userMap.set("Bob", 30);

for (const [name, age] of userMap.entries()) {
    console.log(`${name} is ${age} years old`);
}
// Alice is 25 years old
// Bob is 30 years old

栗子3:表示固定格式的数组

当你需要存储一组固定长度、固定类型的数据时,元组比对象更轻量。

ts 复制代码
let point: [number, number] = [10, 20];
let date: [number, number, number] = [2025, 8, 26]

4.元组与普通数组的区别

特性 元组(tuple) 普通数组(Array)
长度 固定长度 可变长度
类型 每个位置的类型可不同但固定 所有元素的类型都相同
用途 结构化数据,返回多个值 存储相同类型元素的集合
示例 string,number number\[\]或Array<number>
相关推荐
Bolt13 小时前
TypeScript 7.0 来了:当 tsc 用 Go 重写之后
javascript·typescript·go
Flynt20 小时前
装上TypeScript 7.0 RC之后,最让我意外不是10倍提速
typescript·visual studio code
疯狂SQL20 小时前
手写高性能在线 JSON 工具|Web Worker 工程化打包 + 语法自动修复 + 多语言代码生成实战
typescript·json·next.js·web worker·前端性能优化·esbuild·源码实战
Momo__5 天前
TypeScript NoInfer<T>——精准控制泛型推断的工具类型
前端·typescript
退休倒计时6 天前
【每日一题】LeetCode 146. LRU 缓存 TypeScript
算法·leetcode·缓存·typescript
kyriewen6 天前
TypeScript 高级类型:我用 infer 写了一个类型安全的 EventBus,终于搞懂了泛型约束
前端·javascript·typescript
月光刺眼7 天前
Bun + TypeScript 后端入门:从类型约束到 LLM API 调用
后端·typescript
天蓝色的鱼鱼7 天前
Node.js 现在能直接跑 TypeScript 了,tsx 和 ts-node 还需要吗?
前端·typescript·node.js
Oo9207 天前
Bun:下一代 JavaScript/TypeScript 运行时,从入门到实践
typescript·bun
Asize8 天前
Bun + TypeScript 实战:从接口约束到 RESTful 路由设计
后端·typescript·代码规范