تهيئة المسارات الاحتياطية

  • 2 دقائق

هناك مسار ⁧⁩/products⁧⁩ من جانب العميل في تطبيقك المتكامل الذي يعرض قائمة بالمنتجات لقائمة التسوق الخاصة بك. عند الانتقال إلى “/products” في تطبيقك بالنقر على رابط “Products”، سيؤكّد شريط العناوين في المتصفح أنك في “/products”. عند تحديث المستعرض في أثناء وجوده في هذه الصفحة، تريد أن ينعش التطبيق المنتجات ويعرضها مرةً أخرى. ومع ذلك، وبدون مسار احتياطي، سترى خطأ 404 يفيد أنه لا يمكن العثور على الصفحة.

سترى خطأ 404 عند تحديث الصفحة لأن المستعرض يرسل طلبًا إلى النظام الأساسي استضافةً لخدمة ⁧⁩/products⁧⁩. لا توجد صفحة على الخادم باسم ⁧⁩products⁧⁩ لتقديم خدمة.

لحسن الحظ، يسهل حل هذا الأمر من خلال إنشاء مسار احتياطي. المسار الاحتياطي عبارة عن توجيه يطابق كافة طلبات الصفحات غير المتطابقة إلى الخادم.

تكوين المسار الاحتياطي

تدعم Azure Static Web Apps قاعدة التحويل المخصصة والمحددة في ملف staticwebapp.config.json المخصص الواقع في مصدر التطبيق. يمكنك تعريف مسار احتياطي للتنقل في عنصر navigationFallback. يُعرض تكوين مسار احتياطي مشترك أدناه.

{
  "navigationFallback": {
    "rewrite": "index.html",
    "exclude": ["/_framework/*", "/css/*"]
  }
}
إعداد القيمة الوصف
إعادة الكتابة index.html الملف المطلوب تقديمه عندما لا يتطابق المسار مع أي ملفات أخرى.
استثناء ["/_framework/*", "/css/*"] المسار (المسارات) المطلوب تجاهلها من التوجيه الاحتياطي.

يتم تطبيق قاعدة التنقل الاحتياطي بعد أي قواعد توجيه أخرى تظهر في الملف staticwebapp.config.json.

موقع الملف للمسار

الموقع المستحسن لـ staticwebapp.config.json هو داخل المجلد المُعين كـ app_location في ملف سير العمل. ومع ذلك، قد يُوضع الملف في أي موقع داخل مجلد التعليمات البرمجية المصدر لتطبيقك.