React / 系统课时
类型收窄与异常处理
类型收窄与异常处理
来自接口、浏览器存储或异常捕获的值都可能不可信。本课将用 unknown 建立类型边界,再通过类型守卫和判别联合逐步收窄,最终得到既安全又便于维护的输入校验与异常处理代码。
学习目标
- 理解
unknown与any的关键差异,并在使用前完成类型检查 - 编写自定义类型守卫,安全读取不可信对象的属性
- 使用判别联合处理成功、失败和异常分支
从 unknown 开始建立边界
any 会绕过类型检查,错误通常要到运行时才暴露;unknown 则要求先证明值的类型,才能访问属性或调用方法。因此,接口响应、反序列化结果和 catch 捕获值应优先视为 unknown。
收窄的核心不是强制断言,而是执行可验证的运行时检查。常用手段包括 typeof、instanceof、in 运算符和返回类型谓词的自定义函数。
主示例:校验输入并统一异常
下面的示例先判断输入是否为非空对象,再校验字段类型。解析结果使用 kind 作为判别字段,调用方只需根据该字段进入对应分支。
ts
type User = {
id: number;
name: string;
};
type ParseResult =
| { kind: "success"; data: User }
| { kind: "failure"; message: string };
function isRecord(value: unknown): value is Record<string, unknown> {
// 排除 null,因为 typeof null 的结果也是 object
return typeof value === "object" && value !== null;
}
function parseUser(input: unknown): ParseResult {
if (!isRecord(input)) {
return { kind: "failure", message: "输入必须是对象" };
}
const { id, name } = input;
if (typeof id !== "number" || typeof name !== "string") {
return {
kind: "failure",
message: "id 必须是 number,name 必须是 string",
};
}
return { kind: "success", data: { id, name } };
}
function getErrorMessage(error: unknown): string {
if (error instanceof Error) {
return error.message;
}
if (typeof error === "string") {
return error;
}
return "未知异常";
}
function printResult(result: ParseResult): void {
// kind 被判断后,TypeScript 会自动收窄当前联合成员
if (result.kind === "success") {
console.log(`用户 ${result.data.id}: ${result.data.name}`);
return;
}
console.log(`解析失败: ${result.message}`);
}
function main(): void {
const inputs: unknown[] = [
{ id: 1, name: "Ada" },
{ id: "2", name: "Grace" },
null,
];
for (const input of inputs) {
printResult(parseUser(input));
}
try {
throw new Error("网络不可用");
} catch (error: unknown) {
console.log(`捕获异常: ${getErrorMessage(error)}`);
}
}
main();预期输出
text
用户 1: Ada
解析失败: id 必须是 number,name 必须是 string
解析失败: 输入必须是对象
捕获异常: 网络不可用关键边界与常见错误
不要用 input as User 代替校验。类型断言只改变编译器的看法,不会检查真实数据;字段缺失时,后续代码仍可能报错。
判别联合的判别字段应使用稳定的字面量,例如 success、failure 或业务状态码。处理分支时优先覆盖所有成员,联合类型新增状态后才能及时发现遗漏。
异常值不一定是 Error 对象,JavaScript 允许抛出字符串、数字或任意对象。因此,读取 error.message 前必须先通过 instanceof Error 等方式收窄。
按自己的节奏,确认真正理解。