Konwertuj curl na TypeScript

curl2code generuje kod TypeScript przy użyciu natywnego dla przeglądarki fetch API z pełnymi adnotacjami typów. Wygenerowany kod zawiera typowane opcje żądania, poprawną obsługę Response oraz bezpieczne pod względem typów parsowanie JSON. TypeScript dodaje bezpieczeństwo w czasie kompilacji do tego samego Fetch API, które jest używane w czystym JavaScript.

API w czasie wykonywania jest identyczne — TypeScript dodaje statyczne sprawdzanie typów. Otrzymujesz typowane obiekty Headers, RequestInit i Response. Dla niestandardowych kształtów odpowiedzi zdefiniuj interfejs i rzutuj za pomocą await response.json() as MyType. Dla TypeScript po stronie serwera sprawdź nasz konwerter curl na Node.js.

Tak samo jak w Fetch — przekaż nagłówek Authorization w typowanym obiekcie HeadersInit. TypeScript gwarantuje, że nie pomylisz nazw nagłówków, jeśli używasz typowanego pomocnika nagłówków. curl2code generuje poprawnie typowane nagłówki uwierzytelniania z flag curl -u i -H 'Authorization: ...'.

Użyj przeglądarkowego API FormData — TypeScript ma dla niego wbudowane definicje typów. Wywołaj formData.append('file', file) z typowanymi parametrami. Kompilator wyłapuje niezgodne typy w czasie budowania. curl2code konwertuje flagi -F na poprawnie typowane wywołania FormData.

Użyj try/catch z async/await. Typuj błąd w klauzuli catch jako unknown i zawężaj za pomocą instanceof. Sprawdzaj response.ok przed parsowaniem. Definiuj typowane odpowiedzi błędów za pomocą interfejsów dla formatów błędów specyficznych dla API. Daje to gwarancję w czasie kompilacji, że wszystkie ścieżki błędów są obsłużone.

Zdefiniuj interfejs dla oczekiwanego kształtu odpowiedzi, a następnie użyj const data: MyAPI = await response.json(). Do walidacji w czasie wykonywania użyj zod lub io-ts. Ten wzorzec zapewnia bezpieczeństwo typów w całej bazie kodu. Aby uzyskać podobne doświadczenie z typowaniem w innych językach, zobacz curl na Go lub curl na Rust.

Użyj AbortController — TypeScript zawiera pełne definicje typów dla Abort API. Utwórz const controller = new AbortController(), przekaż signal do fetch i przerwij za pomocą setTimeout. Skrót AbortSignal.timeout(ms) jest typowany w nowoczesnych celach bibliotecznych TypeScript.

Obsługa CORS jest identyczna jak w JavaScript — jest to funkcja bezpieczeństwa przeglądarki, a nie TypeScript. Ustaw mode: 'cors' i credentials: 'include' zgodnie z potrzebami, a TypeScript zapewni poprawne wartości wyliczeniowe RequestMode i RequestCredentials. Dla żądań po stronie serwera, gdzie CORS nie ma zastosowania, zobacz curl na Node.js.

Konwertuj polecenie curl POST, takie jak curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL na kod TypeScript za pomocą curl2code. Wygenerowany kod używa const response: Response = await fetch(url, { method: 'POST', body: JSON.stringify(data) }). curl2code automatycznie wykrywa flagi -d/--data z zawartością JSON i ustawia odpowiedni nagłówek Content-Type w kodzie fetch.

Przekaż curl -H "Authorization: Bearer YOUR_TOKEN" URL do curl2code, a narzędzie wygeneruje kod fetch z nagłówkiem autoryzacji: headers: { Authorization: `Bearer ${token}` }. curl2code wykrywa tokeny Bearer zarówno z flag -H "Authorization: Bearer ...", jak i --oauth2-bearer. W przypadku Basic auth użyj -u user:pass.

curl2code konwertuje curl -H "Content-Type: application/json" URL na kod fetch z właściwym nagłówkiem: headers: { 'Content-Type': 'application/json' } as HeadersInit. Dla danych -d curl domyślnie ustawia application/x-www-form-urlencoded; dla przesyłania formularzy -F używa multipart/form-data. curl2code mapuje każde z nich na odpowiednie API fetch.