Công cụ tạo TypeScript SDK và trình mô phỏng mockup từ tệp Swagger.json
SDK (Software Development Kit) ở đây bao gồm các chức năng sau
- tập hợp các hàm fetch
- cấu trúc DTO
- Trình mô phỏng Mockup
Khi build và sử dụng SDK, việc này tiện lợi và an toàn hơn rất nhiều so với việc lập trình viên frontend (client) phải đọc tài liệu swagger rồi chép lại các hàm fetch và kiểu DTO; đồng thời cũng tự động hóa cả việc mock backend server bằng msw, nhờ đó nâng cao năng suất.
6 bình luận
Bài viết hay, cảm ơn vì cách tiếp cận thú vị. Có thể đây chỉ là sở thích cá nhân của tôi, nhưng tôi nghĩ sẽ tốt hơn nếu trong phần nội dung ở trên có các ví dụ kiểu như “thêm đoạn mã này vào thì từ chỗ trước đây hoạt động như thế này sẽ trở thành như thế kia”. Nội dung hiện tại gần như không thu hút được ánh nhìn của tôi.
Trong hệ sinh thái TS, việc đọc tài liệu rồi tự định nghĩa thủ công các kiểu và hàm liên quan có phải là chuyện phổ biến không?
Liên quan đến việc này, có một thư viện tên là Tspec có thể tự động trích xuất OpenAPI Spec dựa trên các kiểu TypeScript nữa hehe
https://github.com/ts-spec/tspec
TS thì đoạn mã do openapi-generator tạo ra không dùng được cho lắm
Dường như đây là cách dùng của một công cụ do chính samchon, người đăng bài này, tự tạo ra, nên tôi cũng nghĩ có lẽ nó nên được đưa sang mục Show GN thì hơn.
Dù sao thì việc dùng file
swagger.jsonđể bật tự động hoàn thành trong client TypeScript có vẻ là một ý tưởng hay. Không biết nó có thể dùng với các stack backend khác ngoài NestJS không?Chỉ cần có thể build
swagger.jsontheo đặc tả OpenAPI v3.0, bất kể ngôn ngữ hay framework nào.Trước đây tôi cũng từng đăng một bài blog kèm show GN, nhưng lúc đó quản trị viên nói rằng show GN là nơi chỉ đăng link GitHub hoặc link dự án, nên đã chuyển nó sang bài viết thường.