第37章 NonNullable工具类型
案例37:NonNullable工具类型——从类型中移除null和undefined
题目:定义函数返回类型时,往往包含null或undefined。本案例演示用NonNullable
设计思路
通过内置工具类型NonNullable
核心代码
// 模拟后端可能返回空值的接口
type ApiResponse = string | null | undefined;
// 使用NonNullable剔除无效值
type ValidData = NonNullable<ApiResponse>; // string
// 实际使用示例
function getUserNickname(): ApiResponse {
// 模拟可能返回null
return Math.random() > 0.5 ? "TypeScript" : null;
}
function displayName(raw: ApiResponse): string {
// 先用NonNullable明确有效类型
const safe: ValidData = raw ?? "匿名用户";
return `昵称: ${safe}`;
}
// 验证:ValidData确实排除了null/undefined
const check: ValidData = "ok"; // 编译通过
// const fail: ValidData = null; // 编译报错
console.log(displayName(getUserNickname()));
运行结果
控制台输出类似:昵称: TypeScript 或 昵称: 匿名用户。类型检查通过,说明NonNullable生效。
验证方法
运行tsc --strict example.ts,若取消注释const fail: ValidData = null;,编译器将报错:Type 'null' is not assignable to type 'string'。这证明类型已收窄。
要点:NonNullable常用于处理API响应、函数返回值等场景,与类型守卫结合可显著提升代码健壮性。
注意:NonNullable不会剔除其他假值(如0、空字符串),它只处理null和undefined。若需排除空字符串,应自定义条件类型。
成果:通过一个小函数,理解了内置工具类型的用法,并掌握类型安全的空值处理方式。
注意事项
1. 使用NonNullable后,仍需在实际运行时处理null(如用??默认值),因为它只影响编译期类型推断。
2. 若目标是剔除所有假值,可组合使用Exclude与自定义条件类型。