تحويل curl إلى TypeScript

ينتج curl2code كود TypeScript باستخدام fetch API الأصلي للمتصفح مع تعليقات توضيحية كاملة للأنواع. يتضمن الكود الناتج خيارات طلب محددة الأنواع، وتعامل صحيح مع Response، وتحليل JSON آمن الأنواع. تضيف TypeScript أماناً في وقت التجميع لنفس Fetch API المستخدمة في JavaScript العادية.

واجهة برمجة التطبيقات في وقت التشغيل متطابقة — تضيف TypeScript فحصاً ثابتاً للأنواع. تحصل على كائنات Headers و RequestInit و Response محددة الأنواع. لأشكال الاستجابة المخصصة، حدد واجهة (interface) واستخدم التحويل مع await response.json() as MyType. لـ TypeScript من جانب الخادم، راجع محول curl إلى Node.js.

بنفس طريقة Fetch — مرر ترويسة Authorization في كائن HeadersInit محدد الأنواع. تضمن TypeScript عدم كتابة أسماء الترويسات بشكل خاطئ إذا كنت تستخدم مساعد ترويسات محدد الأنواع. ينتج curl2code ترويسات مصادقة محددة الأنواع بشكل صحيح من أعلام curl مثل -u و -H 'Authorization: ...'.

استخدم FormData API الخاص بالمتصفح — تمتلك TypeScript تعريفات أنواع مدمجة له. استدعِ formData.append('file', file) مع معاملات محددة الأنواع. يلتقط المترجم الأنواع غير المتطابقة في وقت البناء. يحول curl2code أعلام -F إلى استدعاءات FormData محددة الأنواع بشكل صحيح.

استخدم try/catch مع async/await. حدد نوع الخطأ في كتلة catch كـ unknown وقم بتضييقه باستخدام instanceof. تحقق من response.ok قبل التحليل. حدد استجابات الأخطاء باستخدام واجهات لتنسيقات الأخطاء الخاصة بـ API. يمنحك هذا ضمانات في وقت التجميع بأن جميع مسارات الأخطاء قد تمت معالجتها.

حدد واجهة (interface) لشكل الاستجابة المتوقع، ثم استخدم const data: MyAPI = await response.json(). للتحقق في وقت التشغيل، استخدمها مع zod أو io-ts. يضمن هذا النمط سلامة الأنواع عبر قاعدة الكود الخاصة بك. لتجربة مماثلة في لغات أخرى، راجع curl إلى Go أو curl إلى Rust.

استخدم AbortController — تتضمن TypeScript تعريفات أنواع كاملة لـ Abort API. أنشئ const controller = new AbortController()، ومرر signal إلى fetch، وقم بالإلغاء باستخدام setTimeout. الاختصار AbortSignal.timeout(ms) محدد الأنواع في أهداف مكتبة TypeScript الحديثة.

التعامل مع CORS مطابق لـ JavaScript — إنها ميزة أمان في المتصفح، وليست ميزة في TypeScript. اضبط mode: 'cors' و credentials: 'include' حسب الحاجة، مع ضمان TypeScript لقيم enum الصحيحة لـ RequestMode و RequestCredentials. للطلبات من جانب الخادم حيث لا ينطبق CORS، راجع محول curl إلى Node.js.

قم بتحويل أمر curl POST مثل curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL إلى TypeScript باستخدام curl2code. يستخدم الكود الناتج const response: Response = await fetch(url, { method: 'POST', body: JSON.stringify(data) }). يقوم curl2code تلقائيًا باكتشاف وسوم -d/--data التي تحتوي على محتوى JSON ويضبط ترويسة Content-Type المناسبة في كود fetch.

قم بتمرير curl -H "Authorization: Bearer YOUR_TOKEN" URL إلى curl2code وسيقوم بإنشاء كود fetch مع ترويسة المصادقة: headers: { Authorization: `Bearer ${token}` }. يكتشف curl2code رموز Bearer من كل من وسوم -H "Authorization: Bearer ..." و --oauth2-bearer. بالنسبة لـ Basic auth، استخدم -u user:pass.

يقوم curl2code بتحويل curl -H "Content-Type: application/json" URL إلى كود fetch مع الترويسة المناسبة: headers: { 'Content-Type': 'application/json' } as HeadersInit. بالنسبة لبيانات -d، يستخدم curl افتراضيًا application/x-www-form-urlencoded؛ أما بالنسبة لرفع النماذج باستخدام -F، فإنه يستخدم multipart/form-data. يقوم curl2code بربط كل منها بـ API الصحيح في fetch.