TypeScript 的 generic 函数
官方鏈接
編寫一個(gè)函數(shù),其中輸入的類型與輸出的類型相關(guān),或者兩個(gè)輸入的類型以某種方式相關(guān)。 讓我們考慮一個(gè)返回?cái)?shù)組第一個(gè)元素的函數(shù):
function firstElement(arr: any[]) {return arr[0]; }這個(gè)函數(shù)完成了它的工作,但不幸的是返回類型為 any。 如果函數(shù)返回?cái)?shù)組元素的類型會(huì)更好。
在 TypeScript 中,當(dāng)我們想要描述兩個(gè)值之間的對(duì)應(yīng)關(guān)系時(shí),會(huì)使用泛型。 我們通過(guò)在函數(shù)簽名中聲明一個(gè)類型參數(shù)來(lái)做到這一點(diǎn):
function firstElement<T>(arr: T[]): T {return arr[0]; }const arr: string[] = ['1', '2', '3'];const result = firstElement(arr);console.log(result);const result1:number = firstElement(arr);TypeScript 的類型推斷 - Type inference
function map<Input, Output>(arr: Input[], func: (arg: Input) => Output): Output[] {return arr.map(func); }注意,上面代碼的 Inout,Output 可以被 T, V 替代,但是可讀性不如前者。
Type constrains - 類型約束
我們已經(jīng)編寫了一些可以處理任何類型值的通用函數(shù)。 有時(shí)我們想關(guān)聯(lián)兩個(gè)值,但只能對(duì)某個(gè)值的子集進(jìn)行操作。 在這種情況下,我們可以使用約束來(lái)限制類型參數(shù)可以接受的類型種類。
讓我們編寫一個(gè)函數(shù),返回兩個(gè)值中較長(zhǎng)的一個(gè)。 為此,我們需要一個(gè)長(zhǎng)度屬性,它是一個(gè)數(shù)字。 我們通過(guò)編寫 extends 子句將類型參數(shù)限制為該類型:
function longest<Type extends { length: number }>(a: Type, b: Type) {if (a.length >= b.length) {return a;} else {return b;} }// longerArray is of type 'number[]' const longerArray = longest([1, 2], [1, 2, 3]); console.log(longerArray);// longerString is of type 'string' const longerString = longest("alice", "bob"); console.log(longerString);// Error! Numbers don't have a 'length' property const notOK = longest(10, 100);最后一個(gè)函數(shù)調(diào)用會(huì)出現(xiàn)編譯錯(cuò)誤,因?yàn)?TypeScript 基本類型 number 并不存在名稱為 length 的屬性。
同 Java 相比,TypeScript 的類型約束的強(qiáng)大之處在于,extends 后面緊跟的不需要是 TypeScript 的 built-in type,比如本例里的:
{ length: number }意思是,只要該函數(shù)傳入的類型,至少包含類型為 number 的 length 屬性即可。
Specifying Type Arguments
TypeScript 通常可以在泛型調(diào)用中推斷出預(yù)期的類型參數(shù),但并非總是如此。 例如,假設(shè)您編寫了一個(gè)函數(shù)來(lái)組合兩個(gè)數(shù)組:
function combine<Type>(arr1: Type[], arr2: Type[]): Type[] {return arr1.concat(arr2); }編譯錯(cuò)誤:
解決辦法:使用尖括號(hào)語(yǔ)法,顯式傳入類型參數(shù):這里 T = string | number,意思是接收 string 或者 number 類型均可。
編寫 generic 函數(shù)的最佳實(shí)踐
編寫泛型函數(shù)很有趣,而且很容易被類型參數(shù)沖昏頭腦。 有太多類型參數(shù)或在不需要它們的地方使用約束會(huì)使推理不那么成功,使函數(shù)的調(diào)用者感到沮喪。
最佳實(shí)踐1 - Push Type Parameters Down
function firstElement1<Type>(arr: Type[]) {return arr[0]; }function firstElement2<Type extends any[]>(arr: Type) {return arr[0]; }// a: number (good) const a = firstElement1([1, 2, 3]); // b: any (bad) const b = firstElement2([1, 2, 3]);乍一看,兩種方法似乎相同,但 firstElement1 是編寫此函數(shù)的更好方法。 它的推斷返回類型是 Type,但 firstElement2 的推斷返回類型是 any,因?yàn)?TypeScript 必須使用約束類型解析 arr[0] 表達(dá)式,而不是在調(diào)用期間“等待”解析元素。
最佳實(shí)踐 2- Use Fewer Type Parameters
function filter1<Type>(arr: Type[], func: (arg: Type) => boolean): Type[] {return arr.filter(func); }function filter2<Type, Func extends (arg: Type) => boolean>(arr: Type[],func: Func ): Type[] {return arr.filter(func); }我們創(chuàng)建了一個(gè)不關(guān)聯(lián)兩個(gè)值的類型參數(shù) Func。 這總是一個(gè)危險(xiǎn)信號(hào),因?yàn)檫@意味著想要指定類型參數(shù)的調(diào)用者必須無(wú)緣無(wú)故地手動(dòng)指定一個(gè)額外的類型參數(shù)。 Func 不會(huì)做任何事情,只會(huì)讓函數(shù)更難閱讀和推理!
最佳實(shí)踐3 - Type Parameters Should Appear Twice
function greet<Str extends string>(s: Str) {console.log("Hello, " + s); }greet("world");這個(gè)例子里, Str 只出現(xiàn)了一次,因此根本毫無(wú)必要。
可以簡(jiǎn)寫成:
function greet(s: string) {console.log("Hello, " + s); }請(qǐng)記住,類型參數(shù)用于關(guān)聯(lián)多個(gè)值的類型。 如果一個(gè)類型參數(shù)在函數(shù)簽名中只使用一次,它就沒(méi)有任何關(guān)系。
更多Jerry的原創(chuàng)文章,盡在:“汪子熙”:
總結(jié)
以上是生活随笔為你收集整理的TypeScript 的 generic 函数的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: 详细解读DialogFragment
- 下一篇: TypeScript void 和 un