منشئ سلسلة استعلام URL
ابنِ رابطاً بمعاملات استعلام من أزواج مفتاح/قيمة بترميز النماذج (المسافة +) أو RFC 3986 (%20). استورد معاملات من رابط موجود لتعديلها.
https://example.com/search?q=coffee+%26+tea&page=2
استيراد المعاملات من عنوان URL موجود
ما هو منشئ سلسلة استعلام URL؟
يحوّل منشئ الاستعلام رابطاً أساسياً وقائمة أزواج مفتاح/قيمة إلى رابط مرمَّز بشكل صحيح. اختر ترميز نماذج HTML (المسافة +، كما في URLSearchParams) أو الترميز المئوي الصارم وفق RFC 3986 (المسافة %20)، واستورد معاملات رابط موجود لتعديلها.
كيفية استخدام منشئ سلسلة استعلام URL
- أدخل الرابط الأساسي، مثل
https://example.com/search. - املأ صفوف المفتاح والقيمة؛ استخدم Add parameter لإضافة المزيد و× لحذف صف.
- اختر الترميز.
- انسخ الرابط الناتج. ولتعديل رابط موجود افتح «Import parameters from an existing URL».
مثال
https://example.com/search, q = coffee & tea, page = 2
https://example.com/search?q=coffee+%26+tea&page=2
بترميز RFC 3986: https://example.com/search?q=coffee%20%26%20tea&page=2
متى تستخدم منشئ سلسلة استعلام URL
استخدمه لبناء استدعاءات API أو روابط التتبع أو روابط الاختبار دون ترميز الرموز الخاصة مثل & و= والمسافات يدوياً. وإن أردت فقط قراءة معاملات رابط موجود فمحلل URL أسرع.
كيف يعمل منشئ سلسلة استعلام URL
تُتخطى الصفوف ذات المفتاح الفارغ وتُرمَّز القيم مرة واحدة بالضبط. يستخدم ترميز النماذج URLSearchParams.toString()؛ ويستخدم وضع RFC 3986 الدالة encodeURIComponent ويهرّب إضافة ! ' ( ) *. تُستبدل أي سلسلة استعلام موجودة في الرابط الأساسي ويبقى #fragment في النهاية. يقسّم الاستيراد الرابط عند ? و# ويفك الأزواج بـ URLSearchParams.
حالات الاستخدام الشائعة
- بناء رابط بحث تحتوي قيمته على & أو =.
- إنشاء روابط حملات موسومة بـ UTM.
- تجهيز طلبات GET مرمّزة لاختبار API.
- تعديل معامل واحد في رابط طويل دون إفساد البقية.
الأسئلة الشائعة
هل تكون المسافات + أم %20؟
يفهم معظم الخوادم الاثنين في سلاسل الاستعلام. تأتي + من ترميز نماذج HTML؛ و%20 هو ترميز URI العام وأكثر أماناً عندما لا يكون المستقبِل إطار ويب تقليدياً.
هل يمكنني تكرار مفتاح؟
نعم. أضف عدة صفوف بالمفتاح نفسه، مثل tag=a وtag=b؛ وتُحفظ بالترتيب.
هل تُدعم الأحرف غير ASCII؟
نعم، تُرمَّز بهروب مئوي UTF-8، فمثلاً ế تصبح %E1%BA%BF.