مرمّز / فاكّ ترميز الروابط
رمّز النص بترميز النسبة المئوية ليكون آمنًا في سلاسل الاستعلام والمسارات والأجزاء، أو فكّ ترميز رابط مرمّز إلى نص مقروء.
المدخل
المخرجات
طريقة استخدام أداة ترميز عناوين URL وفك ترميزها
الصق النص أو عنوان URL واختر وضعًا. ترميز قيمة (encodeURIComponent) هو ما تحتاجه في معظم الأحيان، لقيم مَعلمات الاستعلام. أما ترميز عنوان URL كامل (encodeURI) فيترك رموز البنية / ? & # دون تغيير. ويعكس فك الترميز أيًّا منهما. تتحدّث النتيجة أثناء الكتابة.
لماذا يهم الترميز
لا تسمح عناوين URL إلا بالحروف والأرقام في ASCII ومجموعة صغيرة من الرموز المحجوزة. أما المسافات والرموز التعبيرية والحروف المشكّلة وعلامات & داخل القيم وعلامات الاقتباس، فكلها تحتاج إلى ترميز بالنسبة المئوية. ومن دون ترميز، ينكسر عنوان URL عند أول علامة & داخل قيمة، أو يُقطع عند أول مسافة، أو يُرجع خطأ 404 عند حرف UTF-8. والترميز بالنسبة المئوية هو الحل المعتمد.
حالات استخدام شائعة
- إنشاء عناوين URL لحملات بوسوم UTM تحتوي على مسافات أو حروف مشكّلة
- ترميز بيانات النماذج لطلبات GET
- تصحيح روابط التتبع التي تبدو مَعلماتها تالفة
- إنشاء نقاط نهاية API تتضمن محتوى من إنشاء المستخدمين في المسار
- ترميز الحروف غير اللاتينية (اليابانية والعربية والسيريلية) لعناوين URL
- فك ترميز عناوين URL من السجلات لتصبح مقروءة من جديد
encodeURI مقابل encodeURIComponent
encodeURI مخصص لعناوين URL الكاملة. فهو يترك رموز البنية مثل / ? & # دون تغيير لأن لها معنى في عنوان URL. أما encodeURIComponent فمخصص للقيم المفردة ويرمّز كل ما يحتاج إلى ترميز، بما في ذلك / و&. استخدم encodeURIComponent لقيم مَعلمات الاستعلام، وencodeURI لعناوين URL الكاملة التي جمعتها من أجزاء موثوقة.
الأسئلة الشائعة
لماذا تتحول المسافة أحيانًا إلى + وأحيانًا إلى %20؟
كلاهما يمكن أن يمثّل مسافة، لكن في مواضع مختلفة. في سلاسل الاستعلام القادمة من نماذج HTML، تشيع علامة +. أما في المسارات، فلا يصلح إلا %20. وتستخدم أدوات الترميز في JavaScript دائمًا %20 لتجنّب الالتباس.
هل أحتاج إلى ترميز # و&؟
داخل قيمة المَعلمة، نعم، وإلا ستُقرأ & على أنها بداية المَعلمة التالية. أما في الجزء الذي يلي #، فلا مشكلة في علامة &. وفي المسار، رمّز # لكن اترك الشرطات المائلة كما هي.
لماذا تتشوّه الرموز التعبيرية في عناوين URL؟
الرموز التعبيرية حروف UTF-8 متعددة البايتات، ولا ترمّزها أنظمة كثيرة بالنسبة المئوية تلقائيًا. مرّر المحتوى الذي ينشئه المستخدمون عبر encodeURIComponent قبل إضافته إلى عنوان URL.
هل سيعطّل الترميز بكسل التتبع لديّ؟
فقط إذا رُمّز مرتين. انتبه إلى ظهور %2520 حيث كنت تتوقع %20. فكّ الترميز مرة واحدة، ثم رمّز مرة واحدة.