品牌类型(Branded Type)
一句话解释
品牌类型添加幻影字段以区分结构相同的类型——防止 UserId/UserEmail 混淆。
用大白话说
品牌类型(也称名义类型模拟)向类型添加唯一幻影属性,使其与具有相同底层结构的其他类型不同。例如,UserId 和 OrderId 都是字符串,但你不想在期望 OrderId 的地方传入 UserId。品牌化使它们不兼容:type UserId = string & { readonly __brand: "UserId" }
__brand 属性在运行时不存在——纯粹是类型级标记。这在编译时捕获一整类 bug(传入错误 ID)。要创建品牌值,你使用断言品牌的构造函数。
示例
typescript
type UserId = string & { readonly __brand: "UserId" };
type OrderId = string & { readonly __brand: "OrderId" };
// Constructor functions
function userId(s: string): UserId { return s as UserId; }
function orderId(s: string): OrderId { return s as OrderId; }
function getUser(id: UserId) { /* ... */ }
const uid = userId("user-123");
const oid = orderId("order-456");
getUser(uid); // OK
// getUser(oid); // Error! OrderId is not UserId
// getUser("raw-string"); // Error! string is not UserId__brand 幻影属性使 UserId 和 OrderId 在编译时不兼容,尽管它们在运行时都是字符串。
常见混淆
容易混淆的对象: 类型别名
关键区别: 类型别名(type UserId = string)创建新名称但 UserId 和 string 可互换——无类型安全。品牌类型(type UserId = string & { __brand: 'UserId' })使它们不兼容——不能在期望 UserId 的地方传入普通字符串。
相关术语
相关资源
相关课程
- TypeScript 高级类型
品牌类型。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。