ts 類型體操之內(nèi)置工具類型(上)

在 TypeScript 中,內(nèi)置工具類型(utility types)是一組預定義的類型字旭,用于在類型層面上進行各種操作对湃。對于 ts 開發(fā)者來說,開始使用這類工具是一個走出新手村的重要標志遗淳。截止至 2024 年 8 月拍柒,ts 官方共提供了 22 個內(nèi)置的工具類型。大家可以在官網(wǎng)查看具體的文檔屈暗。當然拆讯,本文并不是來集中介紹這些類型的用法,我們要更近一步养叛,來看看如何用更底層的類型方法來實現(xiàn)這些工具類型种呐。

Record

我們先從最簡單的入手

Record<K, T>K 中的每個屬性值轉(zhuǎn)化為 T 類型,例如:

type Animal = 'Dog' | 'Cat';

type AnimalRecord = Record<Animal, string>;
// type AnimalRecord = {
//     Dog: string;
//     Cat: string;
// }

Record 的實現(xiàn)如下:

type Record<K extends keyof any, T> = {
  [P in K]: T;
};

type K = keyof any; // string | number | symbol

Record 是最最常用的一個工具類型弃甥,實現(xiàn)也極其簡單爽室,只需要用到我們在上期中介紹的類型映射。簡單遍歷第一個泛型 K 的每一個屬性潘飘,并將屬性值都轉(zhuǎn)成第二個泛型 T 類型肮之。 這里對 K 做了限制,就是它只能是 string卜录、 number 和 symbol 的一種。我們再簡單展開一下眶明, keyof any 等價于聯(lián)合類型string | number | symbol艰毒;如果是老手,你可能還會知道 ts 定義了一個原生類型 type PropertyKey = string | number | symbol搜囱,有時候偷個懶不想寫一大串string | number | symbol丑瞧,可以直接使用PropertyKey秀一把柑土。

Partial & Required & Readonly

Partial<T>: 將 T 的所有屬性變?yōu)榭蛇x,例如:

type Vegetable = {
  Onion: string;
  Garlic: number;
};

type PartialVegetable = Partial<Vegetable>;
// type PartialVegetable = {
//     Onion?: string;
//     Garlic?: number;
// }

Partial 的實現(xiàn)如下:

type Partial<T> = {
  [P in keyof T]?: T[P];
};

這里有個知識點: 在冒號前加個 ? (等價于+?)就表示該鍵值的類型是可選類型(即有可能是 undefined).

Required<T>: 把所有屬性變成必選

+? 操作绊汹,自然也有 -?稽屏,Required 就是Partial的反向操作:

type Required<T> = {
    [P in keyof T]-?: T[P];
};


type Vegetable = {
  Onion?: string;
  Garlic西乖?: number;
};

type RequiredVegetable = Required<Vegetable>;
// type RequiredVegetable = {
//     Onion: string;
//     Garlic: number;
// }

Readonly<T>: 將所有屬性變成只讀

類似加減 ? 的操作還有一個就是:加減 readonly狐榔,只不過 readonly 要放在屬性的最前面。

再看看 Readonly 的實現(xiàn)(這里readonly等價于+readonly):

type Readonly<T> = {
  readonly [P in keyof T]: T[P];
};

正好获雕,我們再做個練習題: Mutable

實現(xiàn)通用的 Mutable<T>, 使得T中的所有屬性都是可變的(不是只讀的)

interface Todo {
  readonly title: string;
  readonly completed: boolean;
}

type MutableTodo = Mutable<Todo>; // { title: string; completed: boolean; }

很簡單薄腻,-readonly 就行

type Mutable<T extends object> = {
  -readonly [K in keyof T]: T[K];
};

Exclude & Extract & Pick & Omit

我們稍增加一點難度,實現(xiàn)一些有兩個泛型的類型

Exclude<T, U>: 從T中剔除那些可賦值給U的類型

Exclude主要用戶聯(lián)合類型的造作届案。如下所示從聯(lián)合類型 a' | 'b' 中剔除c ( c'a' | 'c'的子集 ) 得到 b

type C = Exclude<'a' | 'b', 'a' | 'c'>; // 'b'

答案很簡單直接用 extends 判斷就行了:

type Exclude<T, U> = T extends U ? never : T;

不過這里要補充個 extends 的知識點庵楷,

T extends U ? never : T 實際執(zhí)行時是對聯(lián)合類型T里的每一個元素分別進行條件判斷,然后對每一個條件判斷的結(jié)果再組裝成新的聯(lián)合類型楣颠。以 Exclude<'a' | 'b', 'a' | 'c'> 為例:實際執(zhí)行時

  1. 等于 ('a' extends 'a' | 'c' ? never : 'a') | ('b' extends 'a' | 'c' ? never: 'b')尽纽;
  2. 等于 (never) | ('b')
  3. 等于 'b' (任何元素和never的聯(lián)合類型等于其本身)

聯(lián)合類型的條件判斷本質(zhì)上在進行“遍歷”童漩,這是個很有趣的語法特性蜓斧。我們這里暫不展開了,之后我會在實際的案例中解釋如何用這個特性解決一些需要依靠遍歷來破解的問題睁冬。

Extract<T, U>: 從T中提取可賦值給U的類型

Exclude的反向操作就是Extract挎春,就是剔除不包含在U里的類型。這個太簡單了豆拨,一筆帶過:

type Extract<T, U> = T extends U ? T : never;

Pick<T, K>: 從 T 中直奋,提取出所有鍵值在聯(lián)合類型 K 中的屬性

如下所示,我只想保留 Todo 類型里的 title 和 completed鍵值對:

interface Todo {
  title: string;
  description: string;
  completed: boolean;
}

type TodoPreview = Pick<Todo, 'title' | 'completed'>;
// type TodoPreview = {
//     title: string,
//     completed: boolean
// }

Pick<T, K>施禾,這里有兩個考點:

  1. K 的取值:K 應該是 T 里已經(jīng)存在的鍵值脚线,比如你傳個 hello 需要拋錯
  2. K 是個聯(lián)合類型,所以需要遍歷

我們看看實現(xiàn):

type Pick<T, K extends keyof T> = {
  [P in K]: T[P];
};

答案還是一個簡單的類型映射:

  1. 通過 K extends keyof T 限定 K 必須是T的所有鍵值的子集
  2. 用個 in 遍歷 K 就行了 (in keyof 不是固定組合……)

Omit<T, K>: 構(gòu)造一個除類型K以外具有T屬性的類型弥搞。

Omit是Pick的反向操作邮绿,排除對象 T 中的 K 鍵值。 Omit在名字上容易和Exclude搞混攀例。記住 Exclude 主要用在聯(lián)合類型船逮,而Omit主要用于對象類型上。如下所示粤铭,我要剔除Todo里的description和title兩個鍵值對:

type TodoPreview = Omit<Todo, 'description' | 'title'>;

// type TodoPreview = {
//     completed: false,
// }

Omit<T, K> 對K沒有特別限制挖胃,只需要是正常的JS對象鍵類型(string | number | symbol)就是了。實現(xiàn)上正好活用一下上面剛提到的方法類型——PickExclude

  1. 從T的所有鍵中剔除(Exclude)掉聯(lián)合類型K(Exclude<keyof T, K>
  2. 提取(Pick)出所有鍵值在上一步得到的結(jié)果中的屬性
type Omit<T, K extends keyof any> = Pick<T, Exclude<keyof T, K>>;

小結(jié)

由于篇幅所限酱鸭,我們暫時先介紹8個最簡單吗垮,但又是最貼近實戰(zhàn)的工具方法。當你開始使用這些工具類型時凹髓,你的新手村小伙伴們一定會眼前一亮的烁登。之后的文章,我會進一步介紹剩下的內(nèi)置工具類型蔚舀,當然他們更加復雜也更能幫助我們提升認知饵沧。敬請期待。

文章同步發(fā)布于an-Onion 的 Github蝗敢。碼字不易捷泞,歡迎點贊。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末寿谴,一起剝皮案震驚了整個濱河市锁右,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌讶泰,老刑警劉巖咏瑟,帶你破解...
    沈念sama閱讀 207,113評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異痪署,居然都是意外死亡码泞,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,644評論 2 381
  • 文/潘曉璐 我一進店門狼犯,熙熙樓的掌柜王于貴愁眉苦臉地迎上來余寥,“玉大人,你說我怎么就攤上這事悯森∷蜗希” “怎么了?”我有些...
    開封第一講書人閱讀 153,340評論 0 344
  • 文/不壞的土叔 我叫張陵瓢姻,是天一觀的道長祝蝠。 經(jīng)常有香客問我,道長幻碱,這世上最難降的妖魔是什么绎狭? 我笑而不...
    開封第一講書人閱讀 55,449評論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮褥傍,結(jié)果婚禮上儡嘶,老公的妹妹穿的比我還像新娘。我一直安慰自己摔桦,他們只是感情好社付,可當我...
    茶點故事閱讀 64,445評論 5 374
  • 文/花漫 我一把揭開白布承疲。 她就那樣靜靜地躺著邻耕,像睡著了一般鸥咖。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上兄世,一...
    開封第一講書人閱讀 49,166評論 1 284
  • 那天啼辣,我揣著相機與錄音,去河邊找鬼御滩。 笑死鸥拧,一個胖子當著我的面吹牛,可吹牛的內(nèi)容都是我干的削解。 我是一名探鬼主播富弦,決...
    沈念sama閱讀 38,442評論 3 401
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼氛驮!你這毒婦竟也來了腕柜?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 37,105評論 0 261
  • 序言:老撾萬榮一對情侶失蹤矫废,失蹤者是張志新(化名)和其女友劉穎盏缤,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體蓖扑,經(jīng)...
    沈念sama閱讀 43,601評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡唉铜,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,066評論 2 325
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了律杠。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片潭流。...
    茶點故事閱讀 38,161評論 1 334
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖柜去,靈堂內(nèi)的尸體忽然破棺而出灰嫉,到底是詐尸還是另有隱情,我是刑警寧澤诡蜓,帶...
    沈念sama閱讀 33,792評論 4 323
  • 正文 年R本政府宣布熬甫,位于F島的核電站,受9級特大地震影響蔓罚,放射性物質(zhì)發(fā)生泄漏椿肩。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 39,351評論 3 307
  • 文/蒙蒙 一豺谈、第九天 我趴在偏房一處隱蔽的房頂上張望郑象。 院中可真熱鬧,春花似錦茬末、人聲如沸厂榛。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,352評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽击奶。三九已至辈双,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間柜砾,已是汗流浹背湃望。 一陣腳步聲響...
    開封第一講書人閱讀 31,584評論 1 261
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留痰驱,地道東北人证芭。 一個月前我還...
    沈念sama閱讀 45,618評論 2 355
  • 正文 我出身青樓,卻偏偏與公主長得像担映,于是被迫代替她去往敵國和親废士。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 42,916評論 2 344

推薦閱讀更多精彩內(nèi)容