برمجة

URL.canParse عند استيراد روابط نسبية إلى الموقع

فريق فايندو جروب2 دقائق قراءة0 مشاهدة0 تعليقات
مشاركة:
واجهة محرر روابط تعرض المسار reviews مع عنوان أساس وتوضح الوجهة النهائية في شريط العنوان.

عند نقل بيانات قائمة أو بطاقات، قد تصل الوجهة بصيغة /services أو reviews بدل عنوان كامل. رفض كل رابط نسبي يفقد بيانات صحيحة، بينما قبول أي نص يمكن تحليله قد يسمح بوجهة غير مناسبة لقائمة الموقع. ابدأ بتحديد عنوان الأساس وسياسة الوجهات، ثم اختبر الوجهة المحسوبة قبل حفظها.

اكتب عنوان الأساس بصورة مقصودة

في مثال تعليمي نستخدم https://demo.example/section/. المسار reviews يُحل داخل section، أما /reviews فيبدأ من جذر الموقع. إزالة الشرطة الأخيرة من عنوان الأساس تغير نتيجة المسار الأول. هذه حالة صغيرة قد تنقل روابط كثيرة إلى مستوى مختلف عند استيراد ملف قائمة.

const base = 'https://demo.example/section/';
console.log(URL.canParse('reviews', base));
console.log(new URL('reviews', base).href);
console.log(new URL('/reviews', base).href);
console.log(new URL('reviews', 'https://demo.example/section').href);

المخرجات المتوقعة للعناوين الثلاثة هي /section/reviews ثم /reviews ثم /reviews على نفس المضيف. بدون عنوان أساس، لا يكون المسار النسبي وحده قابلًا للتحليل كعنوان كامل. وURL.canParse تعيد نتيجة منطقية بدل إنشاء كائن تحتاج قراءته.

أضف سياسة القائمة بعد التحليل

في قائمة داخلية تجريبية، نسمح فقط ببروتوكول HTTPS وبنفس origin الخاص بعنوان الأساس. حلل الرابط ثم قارن الخاصيتين. عنوان //other.example/path يمكن تحليله، لكنه ينتقل إلى مضيف مختلف. وبروتوكول mailto قد يكون مفيدًا في رابط البريد، بينما يحتاج عنصر مستقلًا في عقد القائمة إذا كانت الروابط هنا لصفحات الموقع فقط.

لا تعتبر نجاح التحليل دليلًا أن الصفحة موجودة. بعد بناء قائمة الوجهات، افحص استجاباتها وروابطها المعتمدة. وفي تطبيق يخزن الرابط من إدخال المستخدم، طبّق سياسة الخادم كذلك، مع عرض القيمة في HTML بالهروب المناسب. المثال يعالج تحليل الروابط وسياسة قائمة محددة، ولا يغطي جلب عناوين عشوائية من الخادم.

اختبر القيم التي تخدع الفحص البصري

استخدم عنوانًا ناقص البنية، ومسارًا يحتوي ../، وعنوانًا مطلقًا لنفس الموقع، وآخر لمضيف خارجي. اعرض الوجهة النهائية في شاشة مراجعة الاستيراد حتى يراها المحرر. إذا كان الرابط الأصلي يحتاج الحفاظ على معامل بحث أو جزء #، أضفهما للعينة وقارن القيمة بعد التسلسل.

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

قبول الاستيراد

  • كل رابط نسبي يملك عنوان أساس موثقًا.
  • الشرطة النهائية للأساس مختبرة.
  • الوجهات الخارجية تخضع لسياسة صريحة.
  • الرابط غير القابل للتحليل يظهر للمحرر للتصحيح.
  • الصفحات المقصودة تستجيب على المسارات النهائية.

يمكن تطبيق هذه العينة عند استيراد محتوى المدونة وروابط الخدمات إلى تصميم جديد.

مراجع التنفيذ

التصنيفات:برمجة
شارك:

التعليقات

لا توجد تعليقات بعد

أضف تعليقك

كن أول من يعلق على هذا المقال

02 · تابع القراءة

مقالات ذات صلة