محلل URL

Q: لماذا يُعتبر رابطي غير صالح؟

يحتاج المحلل إلى رابط مطلق ببروتوكول. `example.com/page` مرجع نسبي؛ اكتب `https://example.com/page`.

قسّم أي رابط إلى البروتوكول وبيانات الاعتماد والمضيف والمنفذ ومقاطع المسار ومعاملات الاستعلام والجزء، بقيم مفكوكة ومخرجات JSON. يعمل داخل متصفحك.

عنوان URL

المخطط (البروتوكول)	https:
اسم المستخدم	user
كلمة المرور	pass
اسم المضيف	shop.example.com
المنفذ	8080
المسار	/products/shoes
مقاطع المسار (بعد فك الترميز)	1. products 2. shoes
سلسلة الاستعلام	?color=red&size=42
المقطع (#)	#reviews
الأصل (origin)	https://shop.example.com:8080
عنوان URL الموحَّد	https://user:pass@shop.example.com:8080/products/shoes?color=red&size=42#reviews

معاملات الاستعلام (2)

المفتاح	القيمة بعد فك الترميز
color	red
size	42

JSON

{
  "protocol": "https:",
  "username": "user",
  "password": "pass",
  "hostname": "shop.example.com",
  "port": "8080",
  "pathname": "/products/shoes",
  "search": "?color=red&size=42",
  "hash": "#reviews",
  "origin": "https://shop.example.com:8080",
  "params": {
    "color": "red",
    "size": "42"
  }
}

ما هو محلل الروابط URL؟

يقسّم محلل URL الرابط إلى مكوناته: البروتوكول واسم المستخدم وكلمة المرور واسم المضيف والمنفذ والمسار ومقاطعه وسلسلة الاستعلام والمعاملات منفردة والجزء (fragment)، ويعرض الأصل (origin) والرابط المُطبَّع. تُفك القيم المرمّزة بالنسبة المئوية، وتُعرض أسماء المضيفين الدولية بصيغتي punycode وUnicode، وتُحفظ المعاملات المتكررة.

كيفية استخدام محلل الروابط URL

الصق رابطاً مطلقاً، مثل https://user:pw@example.com:8080/a/b%20c?x=1&y=two#h.
اقرأ جدول المكونات؛ ويعرض صف المنفذ المنفذ الافتراضي إن لم يُحدَّد منفذ.
راجع جدول معاملات الاستعلام لكل مفتاح وقيمة مفكوكين.
انسخ كتلة JSON لاستخدام النتيجة المحللة في الكود أو الاختبارات.

مثال

الإدخال

https://user:pw@example.com:8080/a/b%20c?x=1&y=two#h

الإخراج

host example.com · port 8080 · path segments: 1. a, 2. b c · query ?x=1&y=two (x = 1, y = two) · fragment #h

متى تستخدم محلل الروابط URL

استخدمه لتشخيص روابط التتبع وروابط إعادة توجيه OAuth والروابط الموقّعة أو استدعاءات API ذات المعاملات الكثيرة. يحلل الروابط المطلقة فقط؛ وللمسارات النسبية أضف أساساً مثل https://example.com أولاً. ولا يزور الرابط.

كيف يعمل محلل الروابط URL

يُحلَّل الرابط بصنف URL المدمج في المتصفح وفق WHATWG، وهو المحلل نفسه الذي تستخدمه المتصفحات في التنقل، فتطابق النتيجة سلوك المتصفح الفعلي (مضيف بأحرف صغيرة وحل مقاطع النقاط وpunycode للنطاقات الدولية). تأتي معاملات الاستعلام من URLSearchParams الذي يفك + إلى مسافة ويفك الهروب المئوي بترميز UTF-8. تُفك مقاطع المسار بـ decodeURIComponent وتُترك كما هي إن احتوت هروباً غير صالح.