TypeScript 裡若相似的型別宣告反覆出現,就會想找從輸入型別計算結果型別的方法。重點不在少了多少字,而在讀者能否清楚看出型別之間的關係。本文用虛構配送通知服務介紹條件型別與 infer,並與確認外部資料實際是否正確的工作區分。
1. 條件型別是以型別為輸入的分支
官方條件型別文件說明依 extends 條件選結果型別的語法。下面依是否為字串型別,產生布林字面值型別;它不是在執行時檢查字串的函式。
type IsText<T> = T extends string ? true : false;
type NameIsText = IsText<'parcel'>; // true
type CountIsText = IsText<3>; // false
假設建立配送通知的函式接收字串識別碼,內部處理函式卻接收數值識別碼。使用條件型別前,應能說明為何區分兩者。意義確實不同,獨立名稱便有幫助;只是表示差異,統一輸入格式可能更易讀。不要用型別技巧掩蓋資料設計的模糊。
檢討型別時,成對記下預期輸入與結果。把字串、數值、聯集及非預期輸入分成小例子,可降低閱讀複雜宣告的負擔。也確認註解結果與編輯器推論是否一致。型別名稱看似自然,實際計算仍可能不同。
2. 聯集分配會改變陣列的含義
型別參數直接位於條件左側時,條件會分配到聯集每個成員。若想阻止分配,把整個聯集視為一個整體,可比較用方括號包住的形式。
type SeparateLists<T> = T extends unknown ? T[] : never;
type Together<T> = [T] extends [unknown] ? T[] : never;
type A = SeparateLists<string | number>; // string[] | number[]
type B = Together<string | number>; // (string | number)[]
const a: A = ['a', 'b'];
const b: B = ['a', 1];
第一個是只有字串的陣列,或只有數值的陣列;第二個允許同一陣列混合兩者。整份配送清單只能放一類代碼,還是各項目可用不同類型,會影響適合的結果。畫面上都有方括號,兩個陣列的契約卻不同。
實務出問題時,不要一次讀完複雜工具型別,先逐一放入成員。比較輸入字串、數值以及兩者聯集的結果。分配是否出於本意清楚了,也就能說明增加方括號的理由。檢討記錄不只留最終型別,也留下希望允許的實際值例子。
3. infer 為結構中的型別命名並取出
infer 用於替條件型別中比對到的部分結構命名。以下是只拆開一層 Promise 的小型別。
type OneResult<T> = T extends Promise<infer Value> ? Value : T;
type Parcel = OneResult<Promise<{ tracking: string }>>;
type ParcelList = OneResult<Promise<string[]>>;
程式不會執行或等候非同步作業,只在編譯階段表達結果形狀。若取 Resolved 一類的函式名稱,可能讓人以為實際值已抵達,所以要連同使用位置的脈絡閱讀。執行中的等待仍由非同步程式處理。
若需要遞迴等候後的結果型別,別持續擴充自製單層例子,先看標準工具型別 Awaited。教學例子的簡單與共用工具需求不同。團隊引入新工具時,宜記下哪些輸入與標準型別結果不同,以及為何需要此差異。
4. 用樣板字面值連接事件名稱
樣板字面值型別能把字串字面值的組合表示為型別。配送服務可以用領域和操作組合的事件名稱作例子。
type Scope = 'parcel' | 'address';
type Action = 'created' | 'updated';
type EventName = `${Scope}:${Action}`;
const event: EventName = 'parcel:created';
編譯期能發現名稱拼錯,但所有可組合事件是否真的符合服務規則,是另一回事。例如只支援地址刪除事件,簡單的領域與操作乘積可能無法準確表達規則。此時先考慮把允許事件與 payload 明確對應的設計。
事件越多,讀者能否方便找到實際名稱越重要。與其接續多層自動組合規則,也可讓傳送至外部系統的名稱集中在一份檔案。比較加入抽象前後,新成員會怎樣發現錯誤事件。型別的精細度和易用性需要一起評估。
5. 外部 JSON 必須在執行中檢查
只替 API 回應標示 User 或 Parcel 型別,不保證實際回應具備該結構。來看把外部值當 unknown 接收,再檢查所需欄位的簡單形式。
function hasTracking(value: unknown): value is { tracking: string } {
return typeof value === 'object' && value !== null
&& 'tracking' in value && typeof value.tracking === 'string';
}
const incoming: unknown = { tracking: 'DEMO-001' };
if (hasTracking(incoming)) console.log(incoming.tracking);
這只確認 tracking 欄位是不是字串,不檢查單號是否真的存在,也不檢查使用者是否有權查看該配送。型別縮窄、業務規則與權限檢查是不同責任。官方 Narrowing 文件介紹透過條件判斷縮窄型別資訊的過程。
6. 選擇型別工具的小型檢討順序
先寫兩個應接受的實際值、兩個應拒絕的值,再嘗試以普通聯集和明確的物件宣告表達意思。仍有重複關係時再用條件型別或 infer,引入技巧的理由就清楚了。若閱讀宣告的時間大增,也可只抽出共用部分,其餘保留普通型別。
最後分開執行型別檢查與執行時檢查。確認編譯器拒絕錯誤事件名稱,與確認伺服器漏傳欄位時程式仍能解釋錯誤,是互補的工作。先驗證小例子,再連到實際輸入邊界,型別轉換才有助於安全的應用程式設計。