第99章 泛型默认参数

案例99:泛型默认参数——为泛型指定默认类型

题目:实现一个通用的结果包装器 Result<T, E = string>,当未显式指定错误类型时,默认使用 string 作为错误描述类型。该案例展示泛型默认参数如何简化调用方代码,同时保持类型安全。

设计思路

泛型默认参数允许我们为类型参数提供后备类型。本例定义一个 Result 接口,包含 success 标志、data 和 error 字段。通过 E = string,调用方只需传入数据类型的泛型参数,错误类型自动推断为 string。同时演示工厂函数如何利用默认参数,减少调用时的类型标注负担。

核心代码

interface Result<T, E = string> {
  success: boolean;
  data?: T;
  error?: E;
}

function ok<T, E = string>(data: T): Result<T, E> {
  return { success: true, data };
}

function fail<T, E = string>(error: E): Result<T, E> {
  return { success: false, error };
}

// 使用默认错误类型 string
const r1 = ok<number>(42);
const r2 = fail<number>("数据加载失败");

// 自定义错误类型
const r3 = fail<number, { code: number }>({ code: 404 });

const results: Result<number>[] = [r1, r2, r3];
results.forEach(r => {
  if (r.success) {
    console.log("✅ 值:", r.data);
  } else {
    console.log("❌ 错误:", r.error);
  }
});
运行结果:控制台依次输出: ✅ 值: 42、 ❌ 错误: 数据加载失败、 ❌ 错误: { code: 404 }
测试建议:故意反向使用泛型参数(如 fail<string, number>(123))验证类型错误提示;尝试访问 r2.error 时,TypeScript 会推断其为 string | undefined,而非 unknown。
注意事项:泛型默认参数只能从右侧开始设置,不能中间跳跃(例如 <E = string, T> 是非法的)。默认参数仅在类型推断无法确定时使用,若显式指定则优先采用指定类型。
成功要点:泛型默认参数极大提升 API 的易用性——调用方不必重复书写常用类型,同时保留自定义扩展能力。此模式在 React 组件 Props、Redux Actions 等场景中广泛使用。