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 的剩余部分则不是任意数组,而是一个带可选尾元素的元组,因此调用结构更严格。

选择数组还是元组

当参数数量不固定且元素类型相同时,使用数组类型。参数数量有限、位置含义明确或不同位置类型不同时,使用元组类型。

剩余参数只能有一个,并且必须是最后一个参数。若参数项继续增加、可选组合变多,改用对象参数会比不断扩展元组更易维护。

本课总结

  • 数组剩余参数适合接收任意数量的同类型值
  • 元组剩余参数可以约束参数数量、顺序和每个位置的类型
  • 剩余参数必须位于参数列表末尾,复杂配置应优先改用对象参数

下一课预告

下一课将继续学习函数重载,为同一个函数提供多组安全的调用签名。

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

目录与阅读设置

阅读设置

17

记录一个想法

声明剩余参数

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

登录哪都通