كيفية استخدام استجابة وهمية مقسَّمة إلى صفحات
- اختر النمط والعدد الإجمالي للعناصر وحجم الصفحة.
- اختر الصفحة الأولى/الوسطى/الأخيرة أو صفحة محدّدة.
- ولّد الاستجابات واستخدم كل صفحة لاختبار حالات القوائم والتمرير و«تحميل المزيد» (load more).
مزايا استجابة وهمية مقسَّمة إلى صفحات
- أنماط التقسيم إلى صفحات: برقم الصفحة أو الإزاحة (offset) أو المؤشر (cursor) أو مجموعة المفاتيح (keyset) أو ترويسة Link
- الصفحات الأولى والوسطى والأخيرة في تشغيل واحد، أو أي صفحة محدّدة
- معرّفات عناصر متسلسلة عبر الصفحات ومؤشرات base64url قابلة لفك الترميز
- الروابط وعلامتا hasNext/hasPrev والإجماليات وترويسة X-Total-Count
- حقول عناصر واسم مورد مخصّصة؛ وقابل للتوليد ببذرة (seed)
مثال على استجابة وهمية مقسَّمة إلى صفحات
الصفحة الثانية من ثلاث
الإدخال:
Style: page, total: 25, page size: 10, page: 2النتيجة:
{ "data": [ { "id": 11, … }, …, { "id": 20, … } ], "meta": { "page": 2, "pageSize": 10, "total": 25, "totalPages": 3, "hasPrev": true, "hasNext": true }, "links": { "prev": "…?page=1&pageSize=10", "next": "…?page=3&pageSize=10" } }الأسئلة الشائعة حول استجابة وهمية مقسَّمة إلى صفحات
ما أنماط التقسيم إلى صفحات المدعومة؟
برقم الصفحة (page/pageSize/totalPages)، وoffset/limit، والمؤشر (pageInfo مع مؤشرات base64url مبهمة)، ومجموعة المفاتيح (after_id)، وترويسات Link على نمط GitHub.
لماذا الصفحات الأولى والوسطى والأخيرة؟
لأنها تختبر الحالات الثلاث التي يجب على العميل التعامل معها: غياب رابط السابق، ووجود الرابطين معاً، وصفحة أخيرة ممتلئة جزئياً بلا رابط للتالي. ولّد صفحة محدّدة عندما تحتاج إلى صفحة أخرى.
هل المؤشرات قابلة لفك الترميز؟
نعم. المؤشرات عبارة عن JSON مرمَّز بـ base64url مثل {"id":10,"dir":"next"}، حتى تتمكن من فحصها وصياغتها في الاختبارات.
كيف تُعيَّن معرّفات العناصر؟
بالتسلسل عبر الصفحات (تبدأ الصفحة 2 بحجم 10 من المعرّف 11)، حتى يمكن التحقق من منطق الترتيب وإزالة التكرار.