Převést curl do TypeScript

curl2code generuje kód TypeScriptu využívající nativní prohlížečové fetch API s plnými typovými anotacemi. Vygenerovaný kód obsahuje typované volby požadavku, správné zpracování Response a typově bezpečné parsování JSON. TypeScript přidává bezpečnost v době kompilace ke stejnému Fetch API, které se používá v čistém JavaScriptu.

Runtime API je identické — TypeScript přidává statickou typovou kontrolu. Získáte typované objekty Headers, RequestInit a Response. Pro vlastní tvary odpovědí definujte rozhraní (interface) a přetypujte pomocí await response.json() as MyType. Pro TypeScript na straně serveru se podívejte na náš převodník curl do Node.js.

Stejně jako u Fetch — předejte hlavičku Authorization v typovaném objektu HeadersInit. TypeScript zajistí, že neuděláte překlep v názvech hlaviček, pokud používáte typovaného pomocníka pro hlavičky. curl2code generuje správně typované autentizační hlavičky z přepínačů curl -u a -H 'Authorization: ...'.

Použijte prohlížečové FormData API — TypeScript pro něj má vestavěné definice typů. Volejte formData.append('file', file) s typovanými parametry. Kompilátor zachytí neshodné typy v době sestavení. curl2code převádí přepínače -F na správně typovaná volání FormData.

Použijte try/catch s async/await. Typ chyby v klauzuli catch nastavte jako unknown a upřesněte pomocí instanceof. Před parsováním zkontrolujte response.ok. Definujte typované odpovědi na chyby pomocí rozhraní pro formáty chyb specifické pro dané API. To vám dává záruky v době kompilace, že jsou ošetřeny všechny cesty chyb.

Definujte rozhraní pro očekávaný tvar odpovědi a poté použijte const data: MyAPI = await response.json(). Pro validaci za běhu to zkombinujte s zod nebo io-ts. Tento vzor zajišťuje typovou bezpečnost v celém vašem kódu. Pro podobnou typovanou zkušenost v jiných jazycích viz curl do Go nebo curl do Rustu.

Použijte AbortController — TypeScript obsahuje plné definice typů pro Abort API. Vytvořte const controller = new AbortController(), předejte signal do fetch a přerušte pomocí setTimeout. Zkratka AbortSignal.timeout(ms) je typovaná v moderních cílech knihoven TypeScriptu.

Zpracování CORS je identické s JavaScriptem — je to bezpečnostní funkce prohlížeče, nikoli TypeScriptu. Podle potřeby nastavte mode: 'cors' a credentials: 'include', přičemž TypeScript zajistí správné hodnoty enumů RequestMode a RequestCredentials. Pro požadavky na straně serveru, kde se CORS neuplatňuje, viz curl do Node.js.

Převeďte curl POST příkaz jako curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL do TypeScriptu pomocí curl2code. Vygenerovaný kód používá const response: Response = await fetch(url, { method: 'POST', body: JSON.stringify(data) }). curl2code automaticky detekuje -d/--data přepínače s JSON obsahem a nastaví odpovídající Content-Type hlavičku v kódu pro fetch.

Vložte curl -H "Authorization: Bearer YOUR_TOKEN" URL do curl2code a nástroj vygeneruje kód pro fetch s autorizační hlavičkou: headers: { Authorization: `Bearer ${token}` }. curl2code detekuje Bearer tokeny z přepínačů -H "Authorization: Bearer ..." i --oauth2-bearer. Pro Basic auth použijte -u user:pass.

curl2code převede curl -H "Content-Type: application/json" URL na kód pro fetch se správnou hlavičkou: headers: { 'Content-Type': 'application/json' } as HeadersInit. Pro data u -d curl standardně používá application/x-www-form-urlencoded; pro nahrávání formulářů přes -F používá multipart/form-data. curl2code mapuje každý z nich na správné fetch API.