النقاط الرئيسية
- 01قم بترميز النسبة المئوية لأي نص للاستخدام الآمن في العناوين أو سلاسل الاستعلام بنقرة واحدة.
- 02يدعم نطاق المكون (ترميز كل شيء) ونطاق URI الكامل (يحافظ على الأحرف الهيكلية).
- 03يتعامل مع Unicode — emoji والأحرف غير ASCII مشفرة UTF-8 ثم مشفرة بالنسبة المئوية بايت تلو الآخر.
- 04يعمل بالكامل في متصفحك لا يتم تحميل مدخلاتك أو تسجيلها أبداً.
لماذا يهم ترميز العناوين
العناوين يمكنها فقط أن تحتوي على مجموعة محددة من أحرف ASCII. المسافات والعلامات والإشارات المساوية وأي نص غير ASCII (emoji أحرف صينية نص عربي) يجب أن تُرمز بالنسبة المئوية قبل ظهورها في عنوان. بدون ترميز ستُقرأ المسافة في معامل الاستعلام كفاصل عنوان و & ستُفسر كفاصل بين المعاملات — تتلف الطلب بصمت.
يواجه المطورون ترميز العناوين باستمرار: بناء عناوين طلبات API يدويّاً وتشييد أهداف إعادة التوجيه وتصحيح أخطاء سلاسل الاستعلام الخاطئة أو العمل مع عناوين callback OAuth. يتعامل مرمز العناوين من Handytool مع الترميز وفك الترميز مع سلوك Unicode الصحيح بدون تثبيت وبدون تقريب خادم.
كيفية ترميز العنوان أو فك ترميزه لسلسلة
- 01
الصق النص الخاص بك
اكتب أو الصق السلسلة التي تريد ترميزها — على سبيل المثال قيمة معامل استعلام تحتوي على مسافات أو أحرف خاصة — في صندوق الإدخال.
- 02
اختر نطاق المكون أو نطاق URI الكامل
حدد نطاق المكون لترميز قيمة معامل استعلام واحدة (تهرب من كل حرف محجوز بما في ذلك / و ?). حدد نطاق URI الكامل لترميز عنوان كامل مع الحفاظ على / و ? و # كفواصل هيكلية.
- 03
انقر ترميز أو فك الترميز
انقر ترميز لتحويل النص إلى سلسلة مشفرة بالنسبة المئوية أو فك الترميز لتحويل %20 و %3F وكل تسلسل نسبة مئوية أخرى إلى أحرف قابلة للقراءة.
- 04
انسخ واستخدم النتيجة
انقر على زر النسخ والصق السلسلة المشفرة أو مفك الترميز حيثما تحتاجه — عنوان أو استدعاء API أو ملف config أو محرر الأكواد الخاص بك.
الأحرف التي يجب أن تكون مشفرة في معاملات الاستعلام
لهذه الأحرف معنى خاص في العناوين وتكسر سلاسل الاستعلام إذا تُركت بدون هروب.
- 01المسافة → %20 (أو + في أجسام form-encoded لكن %20 في سلاسل استعلام العناوين).
- 02& → %26 — يفصل معاملات الاستعلام لذا يجب أن يهرب داخل قيمة.
- 03= → %3D — يفصل المفتاح عن القيمة يجب أن يهرب داخل قيمة.
- 04+ → %2B — غالباً ما يُقرأ خطأ كمسافة في الخوادم الأقدم دائماً ترمز بشكل صريح.
- 05# → %23 — يوضح معرف الجزء يرمز داخل أي قيمة.
- 06غير ASCII (emoji CJK إلخ) → بايتات UTF-8 مشفرة كتسلسلات %XX%XX.
ترميز الرموز وبيانات الاعتماد بدون خطر الخصوصية
يعمل مرمز العنوان بالكامل في متصفحك باستخدام encodeURIComponent و encodeURI JavaScript functions الأصلية. لا يتم نقل أي شيء إلى أي خادم. هذا يعني أنه يمكنك بأمان ترميز OAuth tokens أو مفاتيح API أو عناوين إعادة التوجيه الخاصة بدون تلك القيم التي تترك جهازك أبداً.
بمجرد إغلاق أو إعادة تحميل التبويب مدخلاتك تختفي. لا توجد جلسة ولا تسجيل ولا حساب مطلوب.
الأسئلة الشائعة حول مرمز العنوان
ما ترميز العنوان أو ترميز النسبة المئوية؟
يستبدل ترميز العنوان الأحرف التي لها معنى خاص في العناوين — المسافات و & و = و ? والنص غير ASCII — بـ % متبوعاً برقمين سادس عشر. يسمح لك بتضمين النص التعسفي بأمان في عنوان بدون كسر هيكله.
ما الفرق بين ترميز المكون وترميز URI الكامل؟
ترميز المكون (encodeURIComponent) يهرب من كل حرف محجوز بما في ذلك / و ?. استخدمه لقيم معاملات الاستعلام الفردية. ترميز URI الكامل (encodeURI) يحافظ على الأحرف الهيكلية بحيث يبقى العنوان بالكامل صالحاً.
كيف تتعامل الأداة مع Unicode و emoji؟
يتم تحويل أحرف Unicode إلى بايتات UTF-8 أولاً ثم يتم ترميز كل بايت كـ %XX مطابقاً للمعيار الذي تستخدمه كل المتصفحات الحديثة.
هل ترميز العنوان هو نفس ترميز كيان HTML؟
لا. يستخدم ترميز العنوان تسلسلات نسبة مئوية (%20 للمسافة) ترميز كيان HTML يستخدم مراجع مسماة أو رقمية (& لـ &). يخدمون سياقات مختلفة ولا يجب الخلط بينهما.
هل يتم تخزين مدخلاتي في أي مكان؟
لا. الترميز وفك الترميز يستخدمان JavaScript APIs الأصلية للمتصفح. لا شيء يُحمل أو يُسجل أو يُخزن.
هل الأداة مجانية؟
نعم. Handytool مجانية تماماً بدون تسجيل أو حدود استخدام.