Dán khai báo interface, type alias, enum hoặc class của TypeScript để nhận một tài liệu JSON ví dụ thỏa mãn chúng. Literal union, Record, utility type như Pick, Omit và Partial, và interface nối nhau bằng extends đều được lần theo và điền giá trị.
Dùng nó trước khi có API để chuẩn bị dữ liệu giả cho MSW hay json-server, tạo props cho Storybook, hoặc cho đội backend thấy chính xác hình dạng bạn muốn họ gửi.
types.ts. export, import và khai báo hàm có thể lẫn vào; chỉ khai báo kiểu được đọc.enum được tham chiếu để chúng được điền giá trị. Tên kiểu không có trong đầu vào thành null.type UserPage = Page<User>, được ưu tiên hơn chính khai báo generic.HttpResponse.json(...) của handler MSW, test fixture hoặc args của Storybook, rồi chỉnh giá trị.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 là string literal union nên lấy giá trị đầu tiên "email"; string enum Priority lấy giá trị member đầu tiên "low". Record<string, string> thành object có một "key" duy nhất, Date | null được phân giải sang phía không null thành chuỗi ISO, và Pick<Audit, "createdBy"> chỉ giữ key được chọn. locale? tùy chọn cũng được đưa vào.
string → "", number/bigint → 0, boolean → false, any/unknown → null, Date → 1970-01-01T00:00:00.000Z (định dạng của Date.toJSON()).null/undefined, còn intersection (A & B) và interface ... extends gộp các property lại.enum dùng giá trị của member đầu tiên, hoặc 0 với numeric enum không có initializer.Array<T> và Set<T> có một phần tử mẫu; tuple có một giá trị cho mỗi vị trí; Record<K, V>, Map và index signature thành {"key": V}.Partial, Required, Readonly, NonNullable, Pick và Omit.static, accessor get/set và field @Exclude() bị loại.children: TreeNode[]) bị cắt thành mảng rỗng.Khi backend chưa sẵn sàng, hãy tạo dữ liệu giả từ kiểu response của API. UI có thể được dựng trước, và sau này chuyển sang API thật vẫn giữ nguyên các kiểu.
Tạo object mặc định từ kiểu props của component để làm args cho story hoặc dữ liệu render cho React Testing Library. Mọi property bắt buộc đều có mặt, nên không phải đuổi theo lỗi kiểu.
Biến kiểu request phía frontend thành JSON rồi dán vào tài liệu thiết kế API hoặc issue, để lập trình viên backend không dùng TypeScript cũng đọc được cấu trúc ngay.
?) luôn được đưa vào; hãy tự xóa key để test response khi chúng vắng mặt.type UserPage = Page<User>, items: T[] được điền bằng User, và mặc định như <T = string> được áp dụng khi không có đối số. Conditional type bên trong generic vẫn không được tính.T["key"], conditional type và template literal type không được tính.name = "kim", retries = 3) dùng giá trị đó; các initializer khác như new Date() chỉ gợi ý về kiểu.z.infer suy ra thành interface thông thường.Map và Set hiển thị thành object và mảng, nhưng JSON.stringify biến cả hai thành {}, nên trong kiểu response hãy ưu tiên Record hoặc mảng.Date ra dạng chuỗi có đúng không?Đúng. JSON.stringify thay Date bằng kết quả toJSON() của nó, một chuỗi ISO 8601. Phía nhận vẫn nhận được chuỗi, nên hãy khai báo kiểu là string hoặc parse nó.
status: "active" | "inactive" nhận giá trị nào?Literal đầu tiên theo thứ tự khai báo, "active". Hãy sắp xếp lại union nếu bạn muốn hiển thị giá trị khác.
Khai báo class và decorator đều được parse, nên DTO gắn decorator của class-validator chuyển bình thường, và field @Exclude() của class-transformer bị bỏ ra.
Hãy dùng trang JSON → TypeScript cho chiều ngược lại. Các trang riêng khác cũng tạo JSON từ model TypeORM, Sequelize và Mongoose.