JavaScript / TypeScript / 系统课时

声明参数与返回值

声明参数与返回值

函数类型决定调用者能传入什么,也决定调用结果可以怎样使用。本课将完成参数、可选参数、默认值和返回值的声明,并给出判断标准:公共函数优先显式标注,简单内部函数可合理依赖推断。

学习目标

  • 为普通参数、可选参数和默认参数添加类型
  • 明确声明函数返回值并验证调用结果
  • 判断何时保留返回类型推断

参数类型决定调用边界

参数类型写在参数名之后,形式为 参数名: 类型。数组参数若只用于读取,可声明为 readonly T[],避免函数内部增删或重排调用者的数组。带默认值的参数通常不需要再写问号,因为调用时本来就可以省略。

下面的示例计算订单总额,并同时展示显式返回类型与推断返回类型。

ts
interface OrderLine {
  name: string;
  unitPrice: number;
  quantity: number;
}

function calculateTotal(
  lines: readonly OrderLine[],
  discountRate = 0
): number {
  // 折扣率按比例建模,先拒绝不可能的业务输入
  if (discountRate < 0 || discountRate > 1) {
    throw new RangeError("discountRate 必须位于 0 到 1 之间");
  }

  // 只汇总金额,不修改传入的订单行数组
  const subtotal = lines.reduce(
    (sum, line) => sum + line.unitPrice * line.quantity,
    0
  );

  return subtotal * (1 - discountRate);
}

// 返回类型由表达式自动推断为 string
const normalizeName = (name: string) => name.trim().toLowerCase();

const total = calculateTotal(
  [
    { name: "Keyboard", unitPrice: 20, quantity: 2 },
    { name: "Mouse", unitPrice: 10, quantity: 1 }
  ],
  0.1
);

console.log(total.toFixed(2));
console.log(normalizeName("  TypeScript  "));

预期输出:

text
45.00
typescript

调用 calculateTotal 时,第一项必须是订单行数组,函数会按只读方式使用它;第二项若提供则必须是数字。传入字符串折扣或缺少订单行必要字段时,TypeScript 会在编译阶段报错。

可选参数与默认参数

可选参数使用 ?,其类型会包含 undefined。它适合“调用者可以不传,函数需要判断是否存在”的场景。

ts
function formatUser(name: string, nickname?: string): string {
  return nickname === undefined ? name : `${name}(${nickname})`;
}

console.log(formatUser("Ada"));
console.log(formatUser("Ada", "admin"));

预期输出:

text
Ada
Ada(admin)

必填参数不能放在可选参数之后,否则调用位置会变得含糊。若参数有明确默认行为,优先使用默认参数;若“未提供”本身具有业务含义,则使用可选参数并显式处理 undefined。

返回值何时显式声明

公共 API、导出的工具函数、递归函数和业务核心函数,建议显式写出返回类型。这样函数体即使被修改,也不能悄悄改变对外契约;例如 calculateTotal(...): number 若误返回字符串,会立即报错。

局部、短小且返回表达式清晰的函数,可以依赖推断。normalizeName 没有显式写 : string,但编译器能从 trim() 和 toLowerCase() 推断结果为字符串。此时省略标注不会降低可读性。

不要为了“显得完整”重复所有显而易见的类型。参数通常缺少调用上下文,应主动标注;返回值已经由简单表达式唯一确定时,可以让编译器承担重复工作。

区分 void 与 never

void 表示调用者不应依赖返回值,常见于日志记录、事件处理和副作用函数。函数仍会正常结束,只是返回结果没有业务意义。

never 表示函数不会正常返回,例如始终抛出异常或进入无限循环。它也常用于穷尽性检查。两者不能互换:void 会结束,never 不会抵达正常返回点。

常见声明错误

避免使用 any 逃避参数设计,否则错误会从编译阶段推迟到运行阶段。参数可能是多种合法形态时,应使用联合类型、泛型或函数重载,而不是直接放弃检查。

回调函数的返回值还会受到上下文类型影响。单独声明函数时,应根据真实行为标注返回类型;把函数作为参数传递时,则先查看目标回调类型是否要求返回结果。

本课总结

  • 参数类型定义合法输入,默认参数和可选参数分别表达默认行为与可能缺省
  • 公共或关键函数适合显式声明返回类型,简单局部函数可以依赖推断
  • void 表示不使用返回值,never 表示函数无法正常返回

下一课预告

下一课将继续完善函数类型,学习可选参数、剩余参数与函数类型别名如何组合,以便安全描述更灵活的调用方式。

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

目录与阅读设置

阅读设置

17

记录一个想法

声明参数与返回值

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

登录哪都通