ترميز URL وفك ترميزه

لا يجوز أن يحتوي عنوان URL إلا على مجموعة محدودة من أحرف ASCII. وتقسّمها مواصفة RFC 3986، وهي مواصفة صياغة URI الصادرة عام 2005، إلى مجموعتين. الأحرف غير المحجوزة، وهي A–Z وa–z و0–9 والعلامات الأربع - . _ ~، لا تحتاج إلى ترميز أبدًا. أما الأحرف المحجوزة فلها وظائف: فالفواصل العامة : / ? # [ ] @ تفصل بين المخطط والمضيف والمسار والاستعلام والجزء، والفواصل الفرعية ! $ & ' ( ) * + , ; = تفصل بين العناصر داخلها، كما يفعل & و= في سلسلة الاستعلام. وكل ما عدا ذلك، وأي حرف محجوز يُستخدم كبيانات عادية، يجب ترميزه بالنسبة المئوية.

يكتب الترميز بالنسبة المئوية البايت على هيئة % يليه رقمان سداسيان عشريان. يُحوَّل النص أولًا إلى UTF-8، فتصبح المسافة %20، ويصبح الحرف é (بايتان) %C3%A9، ويصبح الإيموجي أربع مجموعات %XX. لذلك يظهر البحث عن "café & bar" في الرابط هكذا: caf%C3%A9%20%26%20bar؛ فالحرف & مُرمَّز كي لا يقرأه الخادم على أنه بداية معامل جديد.

تُعدّ encodeURIComponent الخيار الصحيح لجزء واحد، مثل قيمة في الاستعلام أو مقطع في المسار أو رابط إعادة توجيه يُمرَّر معاملًا. وهي تهرّب كل شيء عدا الأحرف غير المحجوزة و! ' ( ) * التي تتركها JavaScript كما هي لأسباب تاريخية. أما encodeURI (whole URL) فتفترض أن المدخل عنوان كامل أصلًا وتُبقي الأحرف المحجوزة كما هي، فلا يُرمَّز في https://example.com/a b?q=1 سوى المسافة. واستخدام encodeURI على قيمة معامل خطأ شائع: إذ يبقى & أو # داخل القيمة ويكسر الرابط.

يعكس Decode أيًّا من الدالتين. وتستخدم نماذج HTML المرسلة بالطريقة GET الصيغة الأقدم application/x-www-form-urlencoded التي تُكتب فيها المسافة + بدل %20؛ أبقِ خيار Treat + as a space مفعّلًا في هذه الحالة، وألغِ تفعيله حين يكون لعلامة الجمع معنى حرفي كما في رقم الهاتف. وإذا احتوى المدخل على % لا يتبعه رقمان سداسيان عشريان، أو على بايتات ليست UTF-8 صالحة، يفشل فك الترميز برسالة واضحة بدل التخمين. وحين يحتوي النص على سلسلة استعلام تظهر معاملاتها مفكوكة الترميز في جدول أسفل الأداة. وللبيانات الثنائية في عناوين URL يُعدّ Base64url البديل المعتاد.