0Pricing
TypeScript Academy · درس

تحديد أنواع استجابات Fetch باستخدام أغلفة عامة

اكتبوا مساعد fetch محدد الأنواع يعيد أنواعًا آمنة

تحديد أنواع استجابات Fetch باستخدام أغلفة عامة درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

مرحبًا

اكتب دوالًا مساعدة لـ fetch محددة النوع لاستهلاك واجهات HTTP بأمان.

مشكلة fetch

تعيد واجهة fetch البرمجية Promise، بينما تعيد ‎.json()‎ Promise. ومن دون الأنواع، تفقد الشيفرة كل أمانها.
const res = await fetch('/api/user');
const data = await res.json(); // data: any — unsafe

غلاف fetch عام

أنشئ دالة مساعدة لـ fetch محددة النوع تفترض شكل الاستجابة.
async function fetchJson<T>(url: string): Promise<T> {
  const res = await fetch(url);
  if (!res.ok) throw new Error(`HTTP error: ${res.status}`);
  return res.json() as Promise<T>;
}

استخدام الغلاف

استدعِ الغلاف مع وسيط نوع صريح.
interface User { id: number; name: string; }
const user = await fetchJson<User>('/api/users/1');
console.log(user.name); // typed as string

إضافة معالجة الأخطاء

وسّع الغلاف ليُرجع نوع Result.
async function safeFetch<T>(url: string): Promise<Result<T>> {
  try {
    const res = await fetch(url);
    if (!res.ok) return err(new Error(`HTTP ${res.status}`));
    return ok(await res.json() as T);
  } catch (e) { return err(e as Error); }
}

تحديد أنواع خيارات الطلب

حدّد أنواع خيارات fetch لطلبات POST وPUT.
async function postJson<T, B>(url: string, body: B): Promise<T> {
  const res = await fetch(url, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(body),
  });
  return res.json() as Promise<T>;
}

التحقق من الاستجابة

تحقق من شكل الاستجابة قبل إرجاعها كقيمة محددة النوع.

تحديد أنواع AbortController

حدّد نوعي AbortController وAbortSignal للطلبات القابلة للإلغاء.
const ctrl = new AbortController();
const data = await fetchJson<User>('/api/users/1', { signal: ctrl.signal });
setTimeout(() => ctrl.abort(), 5000);

معترض عنوان URL الأساسي

أنشئ صنف عميل HTTP مع عنوان URL أساسي.
class ApiClient {
  constructor(private baseUrl: string) {}
  get<T>(path: string): Promise<T> {
    return fetchJson<T>(`${this.baseUrl}${path}`);
  }
}

رؤوس محددة النوع

حدّد أنواع رؤوس الطلب والاستجابة.
const headers: Record<string, string> = {
  Authorization: `Bearer ${token}`,
  'Content-Type': 'application/json',
};

أنواع الصفحات

حدّد نوع استجابات API المقسّمة إلى صفحات.
interface Paginated<T> { data: T[]; page: number; total: number; }
const result = await fetchJson<Paginated<User>>('/api/users?page=1');

تحقق سريع

ماذا تفعل ‎`res.json() as Promise`‎ داخل غلاف fetch محدد النوع؟

مراجعة

تحديد أنواع استجابات Fetch باستخدام الأغلفة العامة: أتقنتم المفاهيم والأنماط الأساسية.

الأسئلة الشائعة

هل درس «تحديد أنواع استجابات Fetch باستخدام أغلفة عامة» مجاني؟

نعم — نص درس «تحديد أنواع استجابات Fetch باستخدام أغلفة عامة» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

ماذا ستتعلم في «تحديد أنواع استجابات Fetch باستخدام أغلفة عامة»؟

اكتبوا مساعد fetch محدد الأنواع يعيد أنواعًا آمنة تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟

لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.

كم من الوقت يستغرق درس «تحديد أنواع استجابات Fetch باستخدام أغلفة عامة»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟

نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. تحديد أنواع استجابات Fetch باستخدام أغلفة عامة
  2. التحقق وقت التشغيل باستخدام Zod
  3. توليد شيفرة OpenAPI: أنواع مولّدة تلقائيًا
  4. نظرة عامة على عميل tRPC الآمن من ناحية الأنواع
← العودة إلى TypeScript Academy