انتقل إلى المحتوى الرئيسي

المقدمة

قم بتحفيز أخطاء الاختبار (404، 500) عند الطلب للتحقق من أن صفحات الأخطاء الخاصة بك تعرض بشكل صحيح، واطلع على عدد طلبات واجهة برمجة التطبيقات للمشروع.

مزيد من المعلومات حول واجهة مستخدم الوحدة https://doc.oneentry.cloud/docs/category/system

🎯 ماذا تفعل هذه الوحدة؟​

توفر وحدة System أدوات على مستوى النظام. تتيح لك اختبار معالجة صفحات الأخطاء - محاكاة أخطاء 404 و500 للتحقق من أن صفحات الأخطاء الخاصة بك تعرض بشكل صحيح قبل أن يواجه المستخدمون مشكلات حقيقية - وتعرض getApiStat() لقراءة عدد طلبات واجهة برمجة التطبيقات للمشروع.

تقوم طرق الأخطاء (test404، test500) بتحفيز إعادة توجيه إلى صفحة الخطأ المقابلة حتى تتمكن من تأكيد أن معالجة الأخطاء الخاصة بك تم تنفيذها بشكل صحيح. استخدمها أثناء التطوير والاختبار، وليس في كود الإنتاج.

🚀 البدء السريع​

قم بتهيئة الوحدة من defineOneEntry:


const { System } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

اقرأ عدد طلبات واجهة برمجة التطبيقات للمشروع:

// Returns an object with the API request count for the project.
const stat = await System.getApiStat();

console.log('API usage:', stat);

test404() و test500() ترمي عن عمد لممارسة معالجة الأخطاء الخاصة بك، لذا قم باستدعائها داخل try/catch:

try {
  await System.test404();
} catch (error) {
  // Your 404 handling runs here.
  console.log('404 handler fired', error);
}

✨ المفاهيم الأساسية​

ما هي وحدة System؟​

توفر وحدة System أدوات للاختبار والتشخيص:

  • اختبار الأخطاء - محاكاة أخطاء 404 / 500 باستخدام test404() / test500()
  • التحقق من صفحات الأخطاء - تأكيد أن صفحات الأخطاء المخصصة الخاصة بك تعرض
  • استخدام واجهة برمجة التطبيقات - قراءة عدد طلبات واجهة برمجة التطبيقات للمشروع باستخدام getApiStat()
  • أداة تطوير - استخدم طرق الأخطاء أثناء التطوير/الاختبار، وليس في الإنتاج

أنواع الأخطاء​

رمز الخطأالاسممتى يحدثحالة الاستخدام
404غير موجودالمورد المطلوب غير موجودالصفحة غير موجودة، المنتج مفقود
500خطأ في الخادم الداخليحدث خطأ على جانب الخادمفشل قاعدة البيانات، خطأ في الكود

سير عمل الاختبار​

1. Develop custom 404 and 500 pages
   ↓
2. Implement error handling (try/catch, error boundaries)
   ↓
3. Trigger errors with System.test404() / System.test500()
   ↓
4. Verify your error pages display correctly
   ↓
5. Remove the test calls before deploying to production

📋 ما تحتاج إلى معرفته​

طرق الأخطاء مخصصة للاختبار فقط​

استخدم test404() و test500() فقط أثناء التطوير والاختبار - فهي ترمي أخطاء لممارسة منطق المعالجة الخاص بك. قم بتشغيلها في بيئة التطوير/المرحلة، وأزل استدعاءات الاختبار قبل الإنتاج. يجب معالجة أخطاء 404/500 الحقيقية باستخدام try/catch وحدود الأخطاء الخاصة بك.

تسجيل الأخطاء والمراقبة هي مسؤوليتك​

لا تقوم وحدة System بتسجيل أو مراقبة الأخطاء. التسجيل والمراقبة تتم في تطبيقك الخاص أو أدوات الطرف الثالث - استخدم طرق الاختبار لتحفيز الأخطاء حتى تتمكن من تأكيد أن تتبعك يعمل.

صفحات الأخطاء المخصصة هي من إنشائك​

تقوم الوحدة فقط بتحفيز الأخطاء؛ يجب عليك إنشاء صفحات 404 و500 المخصصة ومنطق المعالجة في تطبيقك.

📊 جدول المرجع السريع​

الطريقةالوصفترميحالة الاستخدام
test404()محاكاة خطأ 404 غير موجودخطأ 404اختبار صفحة خطأ 404
test500()محاكاة خطأ 500 في الخادمخطأ 500اختبار صفحة خطأ 500
getApiStat()الحصول على عدد طلبات واجهة برمجة التطبيقات—مراقبة استخدام واجهة برمجة التطبيقات

❓ الأسئلة الشائعة (FAQ)​

متى يجب أن أستخدم طرق الأخطاء؟​

استخدم test404() و test500() فقط أثناء التطوير والاختبار للتحقق من أن صفحات الأخطاء الخاصة بك تعمل بشكل صحيح. لا تستخدمها أبدًا في كود الإنتاج - فهي أداة اختبار بحتة للتحقق من معالجة الأخطاء.

كيف يمكنني اختبار صفحات الأخطاء المخصصة الخاصة بي؟​

استدعِ System.test404() أو System.test500() في بيئة التطوير الخاصة بك، داخل try/catch. تقوم هذه الطرق بإلقاء الأخطاء، مما يحفز منطق معالجة الأخطاء الخاص بك حتى تتمكن من التحقق من أن صفحات الأخطاء المخصصة تعرض بشكل صحيح.

ما الفرق بين test404() و test500()؟​

test404() تحاكي خطأ "غير موجود" (المورد غير موجود)، بينما test500() تحاكي "خطأ في الخادم الداخلي" (فشل على جانب الخادم). اختبر كلاهما للتأكد من معالجة جميع سيناريوهات الأخطاء بشكل صحيح.

ماذا تعيد getApiStat()؟​

تعيد كائنًا يحتوي على عدد طلبات واجهة برمجة التطبيقات للمشروع، وهو مفيد لمراقبة استخدام واجهة برمجة التطبيقات.

🎓 أفضل الممارسات​

  • استخدم طرق الأخطاء في بيئات الاختبار فقط - لا تحفز أخطاء الاختبار في الإنتاج.
  • قم بتغليف استدعاءات الاختبار في try/catch - كل من test404() و test500() ترمي عن عمد.
  • قم بتنفيذ صفحات الأخطاء المخصصة - تقوم الوحدة فقط بتحفيز الأخطاء؛ الصفحات هي من إنشائك.
  • تحقق من تتبع الأخطاء - استخدم طرق الاختبار لتأكيد أن المراقبة/التسجيل تعمل.
  • أزل استدعاءات الاختبار قبل النشر - نظف استدعاءات test404() / test500() قبل الإنتاج.

🔗 الوثائق ذات الصلة​