0Pricing
TypeScript Academy · درس

أنواع Fetch API؛ الأنواع العامة لـ Response.json()

استخدم Fetch API بالأنواع الصحيحة، والأنواع العامة لـ Response.json () لتحليل حمولات JSON بأمان.

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

مقدمة

الهدف: استدعِ واجهات برمجة التطبيقات باستخدام fetch، وتعامل مع الاستجابات بأمان، واستخدم الأنواع العامة مع Response.json().

أساسيات fetch

تعيد fetch قيمة من النوع Promise<Response>. استخدم res.text() مع أجسام الاستجابة النصية العادية.

async function getText() {
  const res = await fetch("/hello.txt");
  const text = await res.text();
  console.log(text);
}

القيمة الافتراضية لـ res.json()

تحلل res.json() جسم الاستجابة، لكن نوع القيمة التي تُرجعها هو any افتراضيًا. لذلك لا يتوفر أمان للأنواع أثناء الترجمة.

async function getData() {
  const res = await fetch("/data.json");
  const data = await res.json();
  console.log(data);
}

‏res.json<T>()

استدعِ res.json<T>() مع واجهة. سيتحقق TS من أنك تستخدم الحقول الصالحة فقط في User.

interface User { id: number; name: string }

async function getUser() {
  const res = await fetch("/user.json");
  const user = await res.json<User>();
  console.log(user.id, user.name);
}

أمان الأنواع

يمنع TypeScript الوصول إلى الحقول غير الموجودة عند استخدام الأنواع العامة مع json<T>.

interface Product { id: number; price: number }

async function getProduct() {
  const res = await fetch("/product.json");
  const p = await res.json<Product>();
  // console.log(p.unknown); // Error: unknown does not exist
}

كتابة أنواع المصفوفات

تعمل الأنواع العامة أيضًا مع المصفوفات، مثل Todo[]. ويضمن TS أن يكون لكل عنصر البنية الصحيحة.

interface Todo { id: number; done: boolean }

async function getTodos() {
  const res = await fetch("/todos.json");
  const todos = await res.json<Todo[]>();
  todos.forEach(t => console.log(t.id, t.done));
}

التحقق من json<T>()

تحقق سريع: ما فائدة استخدام response.json<T>() مع وسيطة نوع؟

مراجعة

مراجعة: تُرجع fetch قيمة من النوع Response. نوع json() الافتراضي هو any. أضف النوع العام json<T> للحصول على أمان الأنواع.

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

هل درس «أنواع Fetch API؛ الأنواع العامة لـ Response.json()» مجاني؟

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

ماذا ستتعلم في «أنواع Fetch API؛ الأنواع العامة لـ Response.json()»؟

استخدم Fetch API بالأنواع الصحيحة، والأنواع العامة لـ Response.json () لتحليل حمولات JSON بأمان. تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

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

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

كم من الوقت يستغرق درس «أنواع Fetch API؛ الأنواع العامة لـ Response.json()»؟

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

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

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

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

  1. أنواع Fetch API؛ الأنواع العامة لـ Response.json()
  2. التحقق في وقت التشغيل باستخدام zod (مقدمة)
← العودة إلى TypeScript Academy