انتقل إلى المحتوى

الترميز بالنسبة المئوية (percent-encoding)

الترميز بالنسبة المئوية يكتب كل بايت من UTF-8 في الرابط علامة % يليها رقمان ستة عشريان؛ ولهذا تظهر العربية في الروابط المنسوخة هكذا: %D9%82%D9%87%D9%88%D8%A9

بالإنجليزية:Percent-encodingآخر تحديث

في هذه الصفحة

التعريف

  • الرابط يتألف من مجموعة محدودة من الأحرف: الحروف والأرقام وبضعة رموز (RFC 3986، القسم 2). وما سواها يُكتب ترميزاً بالنسبة المئوية: علامة % يليها رقمان ستة عشريان لكل بايت (القسم 2.1).
  • الأحرف التي لا تحتاج ترميزاً هي الحروف اللاتينية والأرقام والشرطة - والنقطة . والشرطة السفلية _ والعلامة ~ (القسم 2.3). أما الأحرف المحجوزة، مثل / و? و# و&، فينبغي ترميزها إذا كانت جزءاً من البيانات لا من بنية الرابط (القسم 2.2).
  • تحوّل مواصفة الرابط من WHATWG كل حرف فوق U+007F إلى بايتات UTF-8 مرمّزة بالنسبة المئوية. فالحرف ق (U+0642) بايتاه D9 82، ويُكتب %D9%82. وكلمة قهوة تصير %D9%82%D9%87%D9%88%D8%A9: أربعة حروف عربية، كل منها 6 رموز.
  • علامة % نفسها إذا كانت بيانات تُرمَّز %25 (القسم 2.4 من RFC 3986). وتوصي RFC 3986 بأن يكتب المنتجون الأرقام الستة عشرية بحروف كبيرة، وإن كانت الصغيرة تكافئها.

لماذا يهم

  • الرابط /products/%D9%82%D9%87%D9%88%D8%A9 هو نفسه الرابط الذي جزؤه الأخير قهوة: صيغتان للعنوان نفسه، إحداهما كما يُرسل والأخرى كما يُقرأ. ويعرض مولّد جزء العنوان في Arablyzer الصيغتين.
  • تقول Google في دليل بنية العناوين إن الأحرف غير ASCII ينبغي أن تُرمَّز بالنسبة المئوية في الخاصية href، وتمثّل لذلك بكلمات عربية: الصيغة https://example.com/%D9%86%D8%B9%D9%86%D8%A7%D8%B9/%D8%A8%D9%82%D8%A7%D9%84%D8%A9 موصى بها، وhttps://example.com/نعناع غير موصى بها.
  • يقرأ الزاحف كل فرق في العنوان على أنه صفحة أخرى، كما تشرح قاعدة url-slug-invalid. فاختر صيغة واحدة للعنوان المرجعي (canonical) واستعملها في كل مكان.
  • الترميز السليم هو UTF-8 دائماً. فالبايتات من ترميز آخر، مثل Windows-1256 في %C7%E1، لا تُقرأ UTF-8 صالحاً، فتصل الرسالة أو العنوان مشوّهين أو تُرفض.
  • الترميز مرتين يفسد العربية: تصير % الأولى %25، فيجد المستقبِل بعد فك الترميز مرة واحدة نص %D9%85 لا الحرف.
  • تفحص قاعدة url-slug-invalid جزء العنوان كما يقرؤه الناس بعد فك الترميز، وتفحص قاعدة whatsapp-text-encoding الرسالة التي في رابط واتساب.

مثال

في جافاسكربت:

js
encodeURIComponent('قهوة')
// '%D9%82%D9%87%D9%88%D8%A9'

new URL('https://shop.example/products/قهوة-عربية-2026').pathname
// '/products/%D9%82%D9%87%D9%88%D8%A9-%D8%B9%D8%B1%D8%A8%D9%8A%D8%A9-2026'

// مرمَّزة مرتين:
encodeURIComponent(encodeURIComponent('قهوة'))
// '%25D9%2582%25D9%2587%25D9%2588%25D8%25A9'

الدالة encodeURIComponent تترك الحروف اللاتينية والأرقام و- _ . ! ~ * ' ( ) كما هي (MDN)، فتبقى -2026 في الجزء كما كتبتها.

أخطاء شائعة

  • ترميز النص مرتين، كأن يرمّزه القالب ثم تضيف إضافة ترميزاً ثانياً: تظهر %D9%85… للزائر بدل العربية.
  • تمرير الرابط كله إلى encodeURIComponent: تقول MDN إنها ترمّز أكثر من encodeURI، بما فيها رموز بنية الرابط، فتُرمَّز : و/ و? ويتعطل الرابط. رمّز القيمة وحدها، ثم ركّب الرابط.
  • ترك # أو & خاماً في قيمة: تنتهي سلسلة الاستعلام عند أول # (RFC 3986، القسم 3.4)، ويبدأ بعدها جزء الوسم، وتفصل & بين المعاملات. اكتبهما %23 و%26.
  • كتابة المسافة + في غير نماذج الويب: علامة + للمسافة خاصة بصيغة application/x-www-form-urlencoded التي تستعملها النماذج (WHATWG)، أما في المسار والاستعلام العاديين فالمسافة %20.
  • ترميز الرابط بغير UTF-8 لأن صفحة المصدر محفوظة بترميز آخر: تقول HTML إن النماذج وترميز الروابط يستعملان ترميز المستند افتراضياً.