بنية سلسلة الاستعلام وتحليلها

سلسلة الاستعلام هي الجزء الذي يأتي بعد ? في عنوان URL، وتُستخدم لتمرير معلومات إضافية إلى الصفحة. ففي https://example.com/search?q=book&page=2 تكون سلسلة الاستعلام هي q=book&page=2.

القواعد

سلسلة الاستعلام هي أزواج key=value مربوطة معاً بالرمز &.

• ? — يشير إلى بداية سلسلة الاستعلام
• = — يفصل المفتاح عن قيمته
• & — يفصل بين الأزواج المتعددة
• # — ينهي سلسلة الاستعلام (وما يليه هو fragment/hash)

عندما تحتوي القيمة على أحرف خاصة

إذا احتوت قيمة ما على & أو =، فإنها تتعارض مع الفواصل، لذا يجب ترميز القيمة باستخدام encodeURIComponent. فمصطلح بحث مثل a&b يجب أن يُكتَب q=a%26b للحفاظ على المعامل سليماً. وتُعرَض المسافة على هيئة %20 أو + بحسب طريقة الترميز، وكثيراً ما تعيد أدوات التحليل تحويل + إلى مسافة.

التحليل الآمن

توفّر المتصفحات URLSearchParams للتعامل مع سلاسل الاستعلام بأمان. واللجوء إليها بدلاً من تقسيم النص يدوياً على & يعالج تلقائياً الترميز والمفاتيح المكرّرة والقيم الفارغة.

يقوم تبويب مُحلِّل الاستعلام في هذا الموقع بتفكيك عنوان URL مُلصَق إلى مكوّناته، ويعرض لكل معامل قيمته الأصلية وقيمته المفكوكة جنباً إلى جنب.