Chuyển đổi curl sang TypeScript

curl2code tạo mã TypeScript bằng cách sử dụng fetch API gốc của trình duyệt với đầy đủ các chú thích kiểu (type annotation). Mã được tạo bao gồm các tùy chọn yêu cầu có kiểu dữ liệu, xử lý Response đúng cách và phân tích cú pháp JSON an toàn về kiểu. TypeScript thêm tính an toàn tại thời điểm biên dịch cho cùng một Fetch API được sử dụng trong JavaScript thuần.

API lúc thực thi là giống hệt nhau — TypeScript thêm việc kiểm tra kiểu tĩnh. Bạn nhận được các đối tượng Headers, RequestInit và Response có kiểu dữ liệu rõ ràng. Đối với các cấu trúc phản hồi tùy chỉnh, hãy định nghĩa một interface và ép kiểu với await response.json() as MyType. Đối với TypeScript phía máy chủ, hãy kiểm tra trình chuyển đổi curl sang Node.js của chúng tôi.

Tương tự như Fetch — truyền một header Authorization trong đối tượng HeadersInit có kiểu dữ liệu. TypeScript đảm bảo bạn không viết sai tên header nếu sử dụng một helper headers có kiểu. curl2code tạo các header xác thực có kiểu đúng cách từ các cờ curl -u và -H 'Authorization: ...'.

Sử dụng FormData API của trình duyệt — TypeScript có sẵn các định nghĩa kiểu cho nó. Gọi formData.append('file', file) với các tham số có kiểu. Trình biên dịch sẽ bắt các kiểu không khớp tại thời điểm build. curl2code chuyển đổi các cờ -F thành các lời gọi FormData có kiểu đúng cách.

Sử dụng try/catch với async/await. Định kiểu cho lỗi trong mệnh đề catch là unknown và thu hẹp kiểu với instanceof. Kiểm tra response.ok trước khi phân tích cú pháp. Định nghĩa các phản hồi lỗi có kiểu với các interface cho các định dạng lỗi cụ thể của API. Điều này mang lại cho bạn sự đảm bảo tại thời điểm biên dịch rằng tất cả các luồng lỗi đều được xử lý.

Định nghĩa một interface cho cấu trúc phản hồi mong đợi, sau đó sử dụng const data: MyAPI = await response.json(). Để xác thực tại thời điểm thực thi, hãy kết hợp với zod hoặc io-ts. Mẫu này đảm bảo an toàn kiểu dữ liệu trong toàn bộ codebase của bạn. Để có trải nghiệm định kiểu tương tự trong các ngôn ngữ khác, hãy xem curl sang Go hoặc curl sang Rust.

Sử dụng AbortController — TypeScript bao gồm đầy đủ các định nghĩa kiểu cho Abort API. Tạo const controller = new AbortController(), truyền signal vào fetch và hủy với setTimeout. Cách viết tắt AbortSignal.timeout(ms) đã được định kiểu trong các mục tiêu thư viện TypeScript hiện đại.

Xử lý CORS giống hệt với JavaScript — đó là một tính năng bảo mật của trình duyệt, không phải của TypeScript. Thiết lập mode: 'cors' và credentials: 'include' khi cần thiết, với việc TypeScript đảm bảo các giá trị enum RequestMode và RequestCredentials chính xác. Đối với các yêu cầu phía máy chủ nơi CORS không áp dụng, hãy xem curl sang Node.js.

Chuyển đổi một lệnh curl POST như curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL sang TypeScript bằng cách sử dụng curl2code. Mã được tạo sử dụng const response: Response = await fetch(url, { method: 'POST', body: JSON.stringify(data) }). curl2code tự động phát hiện các cờ -d/--data với nội dung JSON và thiết lập header Content-Type phù hợp trong mã fetch.

Cung cấp curl -H "Authorization: Bearer YOUR_TOKEN" URL cho curl2code và nó sẽ tạo mã fetch với header xác thực: headers: { Authorization: `Bearer ${token}` }. curl2code phát hiện Bearer tokens từ cả hai cờ -H "Authorization: Bearer ..." và --oauth2-bearer. Đối với Basic auth, hãy sử dụng -u user:pass.

curl2code chuyển đổi curl -H "Content-Type: application/json" URL sang mã fetch với header chính xác: headers: { 'Content-Type': 'application/json' } as HeadersInit. Đối với dữ liệu -d, curl mặc định là application/x-www-form-urlencoded; đối với tải lên biểu mẫu -F, nó sử dụng multipart/form-data. curl2code ánh xạ từng loại tới fetch API chính xác.