第37章 NonNullable工具类型

案例37:NonNullable工具类型——从类型中移除null和undefined

题目:定义函数返回类型时,往往包含null或undefined。本案例演示用NonNullable将联合类型中的null与undefined剔除,获得纯净的有效类型。

设计思路

通过内置工具类型NonNullable,它等价于T & {},能排除null和undefined。先构造一个可能返回空值的函数,声明其返回类型为string | null | undefined;随后用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与自定义条件类型。