JavaScript / TypeScript / 系统课时
声明参数与返回值
声明参数与返回值
函数类型决定调用者能传入什么,也决定调用结果可以怎样使用。本课将完成参数、可选参数、默认值和返回值的声明,并给出判断标准:公共函数优先显式标注,简单内部函数可合理依赖推断。
学习目标
- 为普通参数、可选参数和默认参数添加类型
- 明确声明函数返回值并验证调用结果
- 判断何时保留返回类型推断
参数类型决定调用边界
参数类型写在参数名之后,形式为 参数名: 类型。数组参数若只用于读取,可声明为 readonly T[],避免函数内部增删或重排调用者的数组。带默认值的参数通常不需要再写问号,因为调用时本来就可以省略。
下面的示例计算订单总额,并同时展示显式返回类型与推断返回类型。
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 "));预期输出:
45.00
typescript调用 calculateTotal 时,第一项必须是订单行数组,函数会按只读方式使用它;第二项若提供则必须是数字。传入字符串折扣或缺少订单行必要字段时,TypeScript 会在编译阶段报错。
可选参数与默认参数
可选参数使用 ?,其类型会包含 undefined。它适合“调用者可以不传,函数需要判断是否存在”的场景。
function formatUser(name: string, nickname?: string): string {
return nickname === undefined ? name : `${name}(${nickname})`;
}
console.log(formatUser("Ada"));
console.log(formatUser("Ada", "admin"));预期输出:
Ada
Ada(admin)必填参数不能放在可选参数之后,否则调用位置会变得含糊。若参数有明确默认行为,优先使用默认参数;若“未提供”本身具有业务含义,则使用可选参数并显式处理 undefined。
返回值何时显式声明
公共 API、导出的工具函数、递归函数和业务核心函数,建议显式写出返回类型。这样函数体即使被修改,也不能悄悄改变对外契约;例如 calculateTotal(...): number 若误返回字符串,会立即报错。
局部、短小且返回表达式清晰的函数,可以依赖推断。normalizeName 没有显式写 : string,但编译器能从 trim() 和 toLowerCase() 推断结果为字符串。此时省略标注不会降低可读性。
不要为了“显得完整”重复所有显而易见的类型。参数通常缺少调用上下文,应主动标注;返回值已经由简单表达式唯一确定时,可以让编译器承担重复工作。
区分 void 与 never
void 表示调用者不应依赖返回值,常见于日志记录、事件处理和副作用函数。函数仍会正常结束,只是返回结果没有业务意义。
never 表示函数不会正常返回,例如始终抛出异常或进入无限循环。它也常用于穷尽性检查。两者不能互换:void 会结束,never 不会抵达正常返回点。
常见声明错误
避免使用 any 逃避参数设计,否则错误会从编译阶段推迟到运行阶段。参数可能是多种合法形态时,应使用联合类型、泛型或函数重载,而不是直接放弃检查。
回调函数的返回值还会受到上下文类型影响。单独声明函数时,应根据真实行为标注返回类型;把函数作为参数传递时,则先查看目标回调类型是否要求返回结果。
本课总结
- 参数类型定义合法输入,默认参数和可选参数分别表达默认行为与可能缺省
- 公共或关键函数适合显式声明返回类型,简单局部函数可以依赖推断
void表示不使用返回值,never表示函数无法正常返回
下一课预告
下一课将继续完善函数类型,学习可选参数、剩余参数与函数类型别名如何组合,以便安全描述更灵活的调用方式。