Tempel deklarasi interface, alias type, enum atau class TypeScript dan dapatkan contoh dokumen JSON yang memenuhinya. Literal union, Record, utility type seperti Pick, Omit dan Partial, serta interface yang dirangkai dengan extends semuanya ditelusuri dan diisi.
Gunakan sebelum API tersedia untuk menyiapkan mock data MSW atau json-server, membuat props Storybook, atau menunjukkan ke tim backend persis bentuk apa yang Anda ingin mereka kirim.
types.ts. export, import dan deklarasi fungsi boleh tercampur; hanya deklarasi tipe yang dibaca.enum yang direferensikan agar ikut terisi. Nama tipe yang tidak ada di input menjadi null.type UserPage = Page<User>, lebih diutamakan daripada deklarasi generic itu sendiri.HttpResponse.json(...) di handler MSW, test fixture, atau args Storybook, lalu sesuaikan nilainya.type Channel = "email" | "sms" | "push";
enum Priority { Low = "low", High = "high" }
interface Notification {
id: string;
channel: Channel;
priority: Priority;
recipient: { userId: number; locale?: string };
payload: Record<string, string>;
readAt: Date | null;
meta: Pick<Audit, "createdBy">;
}
interface Audit { createdBy: string; createdAt: Date }{
"id": "",
"channel": "email",
"priority": "low",
"recipient": {
"userId": 0,
"locale": ""
},
"payload": {
"key": ""
},
"readAt": "1970-01-01T00:00:00.000Z",
"meta": {
"createdBy": ""
}
}Channel adalah string literal union, jadi mengambil nilai pertamanya "email"; string enum Priority mengambil nilai member pertamanya "low". Record<string, string> menjadi objek dengan satu "key", Date | null diselesaikan ke sisi non-null sebagai string ISO, dan Pick<Audit, "createdBy"> hanya mempertahankan key yang dipilih. locale? yang opsional juga disertakan.
string → "", number/bigint → 0, boolean → false, any/unknown → null, Date → 1970-01-01T00:00:00.000Z (format Date.toJSON()).null/undefined, dan intersection (A & B) serta interface ... extends menggabungkan properti.enum memakai nilai member pertamanya, atau 0 untuk enum numerik tanpa initializer.Array<T> dan Set<T> mendapat satu elemen contoh; tuple mendapat nilai untuk setiap posisinya; Record<K, V>, Map dan index signature menjadi {"key": V}.Partial, Required, Readonly, NonNullable, Pick dan Omit.static, accessor get/set, dan field @Exclude() dikecualikan.children: TreeNode[]) dipotong menjadi array kosong.Sebelum backend siap, buat mock data dari tipe respons API. UI bisa dibangun lebih dulu, dan saat nanti beralih ke API sebenarnya, tipenya tetap sama.
Buat objek default dari tipe props sebuah komponen untuk args story atau data render React Testing Library. Setiap properti wajib sudah ada, jadi tidak ada error tipe yang perlu dikejar.
Ubah tipe request frontend menjadi JSON lalu tempel ke dokumen desain API atau issue, sehingga developer backend yang tidak memakai TypeScript bisa langsung membaca strukturnya.
?) selalu disertakan; hapus key-nya sendiri untuk menguji respons ketika key itu tidak ada.type UserPage = Page<User>, items: T[] diisi dengan User, dan default seperti <T = string> berlaku jika tidak ada argumen. Conditional type di dalam generic tetap tidak dievaluasi.T["key"], conditional type, dan template literal type tidak dievaluasi.name = "kim", retries = 3) memakai nilai itu; initializer lain seperti new Date() hanya menjadi petunjuk tipe.z.infer sebagai interface biasa.Map dan Set ditampilkan sebagai objek dan array, tetapi JSON.stringify mengubah keduanya menjadi {}, jadi utamakan Record atau array di tipe respons.Date keluar sebagai string?Ya. JSON.stringify mengganti Date dengan hasil toJSON()-nya, yaitu string ISO 8601. Sisi penerima tetap mendapat string, jadi beri tipe string atau parse nilainya.
status: "active" | "inactive"?Literal pertama sesuai urutan deklarasi, "active". Ubah urutan union jika Anda lebih suka menampilkan nilai lain.
Deklarasi class dan decorator di-parse, jadi DTO yang diberi decorator class-validator terkonversi dengan baik, dan field @Exclude() dari class-transformer tidak disertakan.
Gunakan halaman JSON → TypeScript untuk arah sebaliknya. Halaman terpisah juga membuat JSON dari model TypeORM, Sequelize, dan Mongoose.