JSON sang TypeScript
JSON sang TypeScript
Chuyển mẫu JSON thành interface và type alias TypeScript, tự động gộp trường từ array object, suy luận trường tùy chọn và union với null, đồng thời tạo khai báo kiểu phù hợp cho array và object rỗng. Phù hợp để dựng model phản hồi API, khởi tạo kiểu cho frontend và sắp xếp cấu trúc dữ liệu.
Bắt đầu nhanh
Tình huống sử dụng phổ biến
Biến phản hồi API thật thành các mô hình TypeScript ban đầu cho trang frontend, SDK client hoặc kiểm thử tích hợp.
Kiểm tra các array object hỗn hợp để xem trường tùy chọn và union type trước khi chốt hợp đồng API.
Chuyển dữ liệu JSON giả lập thành định nghĩa kiểu nhanh cho fixture, Storybook hoặc prototype.
Xem lại các khai báo lồng nhau như User hoặc Meta khi hình dạng payload backend thay đổi.
Gợi ý sử dụng
Giới hạn & khả năng tương thích
Quyền riêng tư & bảo mật
Câu hỏi thường gặp
Root là object sẽ tạo khai báo interface. Root là array và giá trị nguyên thủy sẽ tạo type alias. Với array object ở cấp cao nhất, root vẫn là type alias như type Root = RootItem[];, còn cấu trúc phần tử được khai báo riêng.
Khi không có phần tử mẫu hoặc thuộc tính mẫu, trình tạo không thể suy luận cấu trúc hẹp hơn. Vì vậy nó giữ array rỗng là unknown[] và object rỗng là interface mở rộng Record<string, unknown> cho đến khi bạn dán dữ liệu đại diện hơn.
Nếu tên bạn nhập đã là một TypeScript identifier hợp lệ thì nó sẽ được giữ nguyên, ví dụ APIResponse. Những tên không hợp lệ sẽ được chuẩn hóa thành một PascalCase identifier ổn định trước khi tạo.
Trình tạo hiện tại chuẩn hóa tên lồng nhau từ đường dẫn thuộc tính và giải quyết va chạm một cách xác định. Vì vậy đầu ra mới dùng các tên như User, Meta hoặc FooBarClass thay vì luôn thêm tiền tố từ tên root.
Hợp đồng đầu ra hiện tại cố ý trả về các khai báo thuần không có export. Điều này giữ cho kết quả trung tính, còn bạn có thể tự thêm export để khớp với phong cách dự án.