Chuyển đến nội dung

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.

JSON sang TypeScript

Bắt đầu nhanh

1
Dán một mẫu JSON hợp lệ vào trình soạn thảo bên trái.
2
Tùy chọn: đặt tên kiểu gốc tùy chỉnh như ApiResponse trước khi tạo.
3
Xem lại các khai báo được tạo ở bên phải. Root là object sẽ thành interface; array và giá trị nguyên thủy sẽ thành type alias.
4
Dùng Sao chép hoặc Tải xuống để tái sử dụng đầu ra .ts đã tạo trong dự án của bạn.

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

Hãy dùng mẫu JSON đủ đại diện. Trình tạo chỉ suy luận từ các giá trị bạn dán vào, nên những trường hợp không xuất hiện sẽ không có trong đầu ra.
Array rỗng sẽ trở thành unknown[] và object rỗng sẽ trở thành interface mở rộng Record<string, unknown> cho đến khi bạn cung cấp dữ liệu mẫu phong phú hơn.
Tên khai báo lồng nhau được chuẩn hóa từ tên thuộc tính, vì vậy đầu ra mới thường dùng các tên như User hoặc Meta thay vì dạng cũ có tiền tố từ root.
Việc tạo chỉ chạy với JSON hợp lệ. Hãy sửa lỗi cú pháp trước; trình soạn thảo sẽ hiển thị dòng và cột khi parse thất bại.
Tên root tùy chỉnh hợp lệ sẽ được giữ nguyên; tên không hợp lệ sẽ được chuẩn hóa thành identifier PascalCase TypeScript hợp lệ.

Giới hạn & khả năng tương thích

Công cụ này suy luận type từ dữ liệu mẫu chứ không phải từ schema chính thức. Các trường không xuất hiện trong mẫu sẽ không thể được đoán ra.
Đầu vào phải là JSON nghiêm ngặt. Comment, dấu phẩy cuối và các cú pháp chỉ có trong JavaScript sẽ bị từ chối.
Đầu ra được tạo không bao gồm câu lệnh export. Hãy tự thêm nếu dự án của bạn cần các khai báo được export.
Kết quả chỉ là mã TypeScript tĩnh. Công cụ không tạo validator, parser hay serializer ở runtime.

Quyền riêng tư & bảo mật

Toàn bộ xử lý diễn ra trong trình duyệt; dữ liệu của bạn không rời khỏi thiết bị.

Câu hỏi thường gặp

6

Tiếp tục bước tiếp theo với các công cụ liên quan này.