إرجاع استجابات JSON
استخدم المساعد json() لإرجاع JSON منظّم مع نوع المحتوى الصحيح
إرجاع استجابات JSON درس مجاني في Sveltejs Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Sveltejs Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Sveltejs Academy 4 دروس في المجموع.
المساعد json
استخدم json() من @sveltejs/kit لإعادة JSON مع الترويسات المناسبة.
import { json } from "@sveltejs/kit";
return json({ ok: true });رموز الحالة
مرّر كائن خيارات ثانٍ للتحكم في الحالة والترويسات الإضافية.
return json({ ok: false }, { status: 400 });ترويسات مخصصة
أضف cache-control أو CORS أو أي شيء آخر عبر headers.
return json(data, { headers: { "cache-control": "max-age=60" } });استجابة يدوية
أو أعد كائن Response خامًا إذا كنت تحتاج إلى جسم غير JSON.
return new Response("plain text", { headers: { "content-type": "text/plain" } });جسم آمن من حيث الأنواع
باستخدام TypeScript، يمكنك تحديد نوع جسم الاستجابة لتسهيل استخدامها من جانب المستهلك.
بث JSON
بالنسبة إلى المجموعات الضخمة، ابثّ أجزاءً من JSON مفصولًا بأسطر جديدة.
تقسيم الصفحات
ضمّن nextCursor أو بيانات الصفحة الوصفية في استجاباتك لتسهيل تقسيم الصفحات.
بنية الخطأ
اعتمد غلاف أخطاء متسقًا مثل { error: { code, message } } لتوضيح الأخطاء.
التخزين المؤقت باستخدام ETag
اضبط ترويسات ETag في الاستجابات المستقرة للاستفادة من التخزين المؤقت على مستوى HTTP.
التفاوض على المحتوى
استخدم ترويسة Accept للتبديل بين JSON والتنسيقات الأخرى.
أفضل ممارسة
أعد JSON دائمًا في واجهات API، حتى عند حدوث الأخطاء. إذ يتوقع العملاء بنية متسقة.
تحقق سريع
كيف تعيد JSON مع الترويسات المناسبة؟
مراجعة
استخدم json() لإنشاء استجابات JSON سهلة الاستخدام مع الحالة والترويسات. وأعد Response خامًا للمحتوى غير JSON.
الأسئلة الشائعة
هل درس «إرجاع استجابات JSON» مجاني؟
نعم — نص درس «إرجاع استجابات JSON» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Sveltejs Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Sveltejs Academy 4 دروس في المجموع.
ماذا ستتعلم في «إرجاع استجابات JSON»؟
استخدم المساعد json() لإرجاع JSON منظّم مع نوع المحتوى الصحيح تتمرن على Sveltejs Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Sveltejs Academy؟
لا تُشترط خبرة سابقة. Sveltejs Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.
كم من الوقت يستغرق درس «إرجاع استجابات JSON»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Sveltejs Academy هذا؟
نعم. كل درس في Sveltejs Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- +server.js: GET وPOST وPUT وDELETE
- Request وRequestEvent
- إرجاع استجابات JSON
- البث باستخدام ReadableStream