JavaScript / TypeScript / 系统课时
声明剩余参数
声明剩余参数
剩余参数用于接收数量不固定的实参,并把它们收集为一个数组。只写 ...args: any[] 虽然方便,却会失去参数约束;本课将分别使用数组和元组类型,让可变参数函数仍然保持准确的类型检查。
学习目标
- 使用数组类型声明同类型剩余参数
- 使用元组类型约束固定结构的可变参数
- 理解剩余参数的位置和调用边界
数组类型的剩余参数
剩余参数写作 ...参数名: 元素类型[],必须位于参数列表最后。调用时,多余的实参会按顺序收集到数组中;函数内部可以使用普通数组方法处理它们。
当所有可变实参类型一致时,数组类型最合适。例如求和函数可以声明为 ...values: number[],这样字符串、布尔值等错误参数会在编译阶段被拒绝。
元组类型的剩余参数
如果可变部分不是“任意多个同类型值”,而是具有固定顺序和含义的一组参数,可以把剩余参数声明为元组。例如 ...[message: string, code?: number] 表示先接收一条字符串消息,再接收一个可选数字编号。
命名元组元素能直接显示每个位置的职责,编辑器补全也更清楚。它适合包装回调、日志函数或事件派发器,但不应替代字段较多的对象参数。
完整示例
下面的示例同时展示数组剩余参数和元组剩余参数。两个函数都能直接运行,并在调用阶段获得精确的类型约束。
ts
function sum(...values: number[]): number {
return values.reduce((total, value) => total + value, 0);
}
function writeLog(
level: "info" | "error",
...details: [message: string, code?: number]
): string {
// 元组保证第一个值是消息,第二个值若存在则必须是数字
const [message, code] = details;
return code === undefined
? `[${level}] ${message}`
: `[${level}] ${message} (${code})`;
}
function main(): void {
console.log(sum(10, 20, 30));
console.log(writeLog("info", "服务已启动"));
console.log(writeLog("error", "请求失败", 503));
}
main();预期输出
text
60
[info] 服务已启动
[error] 请求失败 (503)sum 可以接收零个或多个数字,零个参数时 reduce 的初始值使结果为 0。writeLog 的剩余部分则不是任意数组,而是一个带可选尾元素的元组,因此调用结构更严格。
选择数组还是元组
当参数数量不固定且元素类型相同时,使用数组类型。参数数量有限、位置含义明确或不同位置类型不同时,使用元组类型。
剩余参数只能有一个,并且必须是最后一个参数。若参数项继续增加、可选组合变多,改用对象参数会比不断扩展元组更易维护。
本课总结
- 数组剩余参数适合接收任意数量的同类型值
- 元组剩余参数可以约束参数数量、顺序和每个位置的类型
- 剩余参数必须位于参数列表末尾,复杂配置应优先改用对象参数
下一课预告
下一课将继续学习函数重载,为同一个函数提供多组安全的调用签名。
按自己的节奏,确认真正理解。