Dán JSON trả về từ API để có ngay interface TypeScript lồng nhau, đặt tên theo khoá, có trường tuỳ chọn và kiểu union. Xuất thêm schema Zod và JSON Schema, chạy hoàn toàn trên trình duyệt.
Cách dùng
- Dán JSON mẫu vào ô JSON mẫu, bấm Mở file hoặc Ví dụ.
- Đặt Tên kiểu gốc (mặc định Root), chọn khai báo
interfacehaytype, bậtexporthoặcreadonlynếu cần. - Chọn thẻ TypeScript, Zod hoặc JSON Schema để xem kết quả.
- Bấm Sao chép hoặc Tải về.
Cách công cụ suy ra kiểu
- Đối tượng lồng nhau thành interface riêng, tên lấy từ khoá theo PascalCase và bỏ dấu tiếng Việt:
diaChi→DiaChi,đơn hàng→DonHang. Phần tử của mảngitemsđược đặt tênItem. - Mảng nhiều đối tượng: mọi phần tử được gộp lại. Khoá chỉ có ở một số phần tử thành tuỳ chọn (
?). Giá trị nhiều kiểu thành union, ví dụ(string | number)[]. - null: trường lúc có giá trị, lúc null thành
string | null. Trường chỉ thấy null, bạn chọn ghi lànull,unknownhoặcany. Mảng rỗng thànhunknown[]. - Gộp kiểu trùng: hai đối tượng có cấu trúc giống hệt nhau dùng chung một interface; cùng tên mà khác cấu trúc thì được đánh số (
Meta,Meta2). - Khoá đặc biệt như
first-nameđược đặt trong nháy kép. - Zod: schema con khai báo trước schema cha, có
.optional(),.nullable(),z.number().int()cho số nguyên, kèmz.infer. - JSON Schema (bản 2020-12): có
required,$defscho đối tượng con, phân biệtintegervànumber.
Mẹo
- Kiểu chỉ đúng với những gì có trong mẫu. Dán một mảng nhiều bản ghi thật để công cụ nhận ra trường tuỳ chọn và trường có thể null.
- Số lớn (ID 19–20 chữ số) vẫn được coi là
number. Nếu API trả về ID dạng số lớn, cân nhắc đổi sangstringhoặcbigint.
Câu hỏi thường gặp
Có cần đăng ký tài khoản không?
Không. Bạn dùng ngay trên trình duyệt, không cần đăng nhập hay cài đặt.
Nên dùng interface hay type?
Với đối tượng, hai cách gần như tương đương. interface có thể mở rộng và gộp khai báo; type linh hoạt hơn với union. Nhiều dự án chọn interface cho dữ liệu API. Công cụ cho phép đổi qua lại bằng một nút.
Vì sao một số trường có dấu hỏi (?)?
Khi JSON gốc là mảng đối tượng, trường không xuất hiện ở mọi phần tử được đánh dấu tuỳ chọn. Điều này giúp TypeScript nhắc bạn kiểm tra trước khi dùng.
Zod là gì và khi nào cần?
Zod là thư viện kiểm tra dữ liệu lúc chạy. Kiểu TypeScript chỉ kiểm tra lúc biên dịch, còn schema Zod kiểm tra dữ liệu thật từ API. Bạn cần cài gói zod trong dự án để dùng đoạn mã được sinh.
JSON của tôi có được gửi lên máy chủ không?
Không. Mọi xử lý diễn ra trên trình duyệt của bạn.
Đánh giá
Chưa có đánh giá nào. Hãy là người đầu tiên!
- 5 sao 0 đánh giá 5 sao
- 4 sao 0 đánh giá 4 sao
- 3 sao 0 đánh giá 3 sao
- 2 sao 0 đánh giá 2 sao
- 1 sao 0 đánh giá 1 sao
Đăng nhập hoặc tạo tài khoản để viết đánh giá.