Ketika deklarasi tipe serupa berulang di TypeScript, kita mencari cara menghitung tipe hasil dari tipe masukan. Yang penting bukan jumlah karakter yang berkurang, tetapi kejelasan hubungan antartipe bagi pembaca. Layanan notifikasi pengiriman rekaan menjadi contoh conditional type dan infer, dibedakan dari pemeriksaan apakah data eksternal benar-benar valid.
1. Conditional type adalah percabangan dengan tipe sebagai masukan
Dokumentasi resmi conditional type menjelaskan pemilihan tipe hasil menurut kondisi extends. Contoh berikut menghasilkan tipe literal boolean berdasarkan apakah masukannya tipe string. Ini bukan fungsi pemeriksa string saat program berjalan.
type IsText<T> = T extends string ? true : false;
type NameIsText = IsText<'parcel'>; // true
type CountIsText = IsText<3>; // false
Misalkan fungsi pembuat notifikasi menerima pengenal string, sedangkan fungsi pemrosesan internal menerima pengenal angka. Sebelum memakai conditional type, jelaskan alasan membedakannya. Jika maknanya benar-benar berbeda, nama terpisah membantu; jika sekadar perbedaan penulisan, menyamakan format masukan mungkin lebih mudah dibaca. Jangan menutupi ambiguitas rancangan data dengan teknik tipe.
Tulis masukan dan hasil yang diharapkan berpasangan. Pecah string, angka, union, dan input tak terduga menjadi contoh kecil agar deklarasi rumit lebih mudah dibaca. Periksa kecocokan komentar hasil dengan inferensi editor. Nama tipe yang tampak masuk akal belum menjamin hasil perhitungannya sama.
2. Distribusi union mengubah arti array
Jika parameter tipe langsung berada di kiri kondisi, kondisi diterapkan ke tiap anggota union secara distributif. Untuk mencegahnya dan memperlakukan seluruh union sebagai satu kesatuan, bandingkan bentuk yang dibungkus tanda kurung siku.
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];
Yang pertama adalah array berisi hanya string atau hanya angka. Yang kedua boleh mencampurkan string dan angka dalam satu array. Hasil yang sesuai bergantung pada apakah seluruh daftar pengiriman harus memakai satu jenis kode atau boleh berbeda per item. Keduanya menampilkan kurung siku, tetapi kontrak kedua array tidak sama.
Saat masalah muncul, masukkan anggota satu per satu alih-alih membaca seluruh utility type rumit sekaligus. Bandingkan hasil untuk string, angka, dan union keduanya. Setelah jelas apakah distribusi disengaja, alasan menambah kurung siku juga dapat dijelaskan. Catatan tinjauan sebaiknya memuat contoh nilai yang ingin diizinkan, bukan hasil akhir saja.
3. infer menamai dan mengambil tipe di dalam struktur
infer dipakai untuk menamai bagian struktur yang dicocokkan dalam conditional type. Berikut tipe kecil yang membuka satu lapisan Promise.
type OneResult<T> = T extends Promise<infer Value> ? Value : T;
type Parcel = OneResult<Promise<{ tracking: string }>>;
type ParcelList = OneResult<Promise<string[]>>;
Kode ini tidak menjalankan atau menunggu pekerjaan asinkron; hanya menyatakan bentuk hasil saat kompilasi. Nama fungsi seperti Resolved bisa memberi kesan nilainya sudah tiba, sehingga konteks tempat tipe digunakan perlu dibaca juga. Penantian saat runtime tetap ditangani kode asinkron.
Jika membutuhkan tipe hasil setelah penantian rekursif, periksa utility type standar Awaited sebelum terus memperluas contoh satu lapisan buatan sendiri. Kesederhanaan contoh pendidikan berbeda dari kebutuhan alat bersama. Saat tim menambah utilitas, dokumentasikan input yang hasilnya berbeda dari tipe standar dan mengapa perbedaan itu diperlukan.
4. Hubungkan nama event dengan template literal
Template literal type menyatakan kombinasi literal string sebagai tipe. Dalam layanan pengiriman, contohnya nama event gabungan lingkup dan tindakan.
type Scope = 'parcel' | 'address';
type Action = 'created' | 'updated';
type EventName = `${Scope}:${Action}`;
const event: EventName = 'parcel:created';
Salah ketik nama dapat ditemukan saat kompilasi, tetapi validitas setiap kombinasi event dalam layanan nyata adalah persoalan lain. Bila hanya event penghapusan alamat yang didukung, perkalian sederhana lingkup dan tindakan mungkin tidak tepat menyatakan aturannya. Pertimbangkan dahulu rancangan pemetaan eksplisit event yang diizinkan dengan payload.
Semakin banyak event, semakin penting pembaca mudah menemukan nama sebenarnya. Alih-alih merangkai banyak tingkat kombinasi otomatis, nama yang dikirim ke sistem eksternal dapat diperiksa dalam satu berkas. Bandingkan bagaimana anggota tim baru menemukan event salah sebelum dan sesudah abstraksi. Kecanggihan tipe dan kemudahan penggunaan perlu dinilai bersama.
5. JSON eksternal harus diperiksa saat runtime
Memberi respons API tipe User atau Parcel saja tidak menjamin struktur respons sebenarnya. Berikut bentuk sederhana menerima nilai eksternal sebagai unknown dan memeriksa field yang diperlukan.
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);
Pemeriksaan ini hanya memastikan field tracking adalah string. Ini tidak memeriksa keberadaan nomor pengiriman nyata atau izin pengguna melihat pengiriman tersebut. Narrowing tipe, aturan bisnis, dan pemeriksaan izin merupakan tanggung jawab berbeda. Dokumentasi resmi Narrowing menjelaskan penyempitan informasi tipe melalui kondisi.
6. Urutan singkat meninjau pilihan alat tipe
Tulis dahulu dua nilai nyata yang diterima dan dua yang ditolak. Lalu coba ungkapkan makna dengan union biasa serta deklarasi objek eksplisit. Jika masih ada hubungan berulang, conditional type atau infer memiliki alasan jelas. Jika waktu membaca deklarasi meningkat tajam, mengekstrak bagian bersama saja dan membiarkan sisanya sebagai tipe biasa juga pilihan.
Terakhir, jalankan pemeriksaan tipe dan runtime secara terpisah. Memastikan kompiler menolak nama event salah melengkapi pengujian apakah program menjelaskan galat ketika server menghilangkan field. Hubungkan hasil contoh kecil yang sudah diperiksa dengan batas masukan nyata, agar transformasi tipe membantu rancangan aplikasi yang aman.