پرش به محتوای اصلی

راهنمای Escape و Unescape

زمان مطالعه: ۲ دقیقه

این ابزار چیست؟

هر زبان و قالبی نویسه‌های ویژه‌ی خودش را دارد: نقل‌قول در رشته‌ی جاوااسکریپت، علامت & در HTML، فاصله و حروف فارسی در نشانی وب، یا آپاستروف در SQL. اگر این نویسه‌ها را بی‌تغییر بگذارید، کد خراب می‌شود یا حتی حفره‌ی امنیتی باز می‌شود. Escape یعنی نوشتن این نویسه‌ها به شکل امن و Unescape یعنی برگرداندنشان به متن اصلی.

این ابزار ده حالت دارد: رشته‌ی JavaScript، JSON، موجودیت‌های HTML، مؤلفه‌ی URL، URL کامل، رشته‌ی SQL، RegExp، رشته‌ی C و Java، فیلد CSV و XML. همه‌چیز در مرورگر شما انجام می‌شود.

گام‌به‌گام

  1. حالت را انتخاب کنید

    قالبی را بردارید که متن قرار است در آن قرار بگیرد؛ مثلاً برای مقدار یک پارامتر در نشانی، «مؤلفه‌ی URL» را.

  2. جهت را تعیین کنید

    برای امن‌سازی متن ساده Escape و برای خواندن متنی که از قبل escape شده Unescape را انتخاب کنید.

  3. متن را بچسبانید

    خروجی همان لحظه ساخته می‌شود. اگر متن escape‌شده نامعتبر باشد، پیام خطا می‌بینید.

  4. در صورت نیاز فقط ASCII بخواهید

    در حالت JavaScript و JSON با «نویسه‌های غیر ASCII به \uXXXX» حروف فارسی هم به کد تبدیل می‌شوند؛ برای فایل‌هایی که رمزگذاری‌شان مطمئن نیست مفید است.

نمونه‌های کاربردی

  • پارامتر فارسی در نشانی

    فاصله، حروف فارسی، & و = طوری کدگذاری می‌شوند که مقدار یک پارامتر را نشکنند.

    جست و جو&x=1

    نتیجه: %D8%AC%D8%B3%D8%AA%20%D9%88%20%D8%AC%D9%88%26x%3D1

  • نمایش امن کد HTML

    برای نشان دادن تکه‌ای HTML به‌عنوان متن، نویسه‌های < و > و & و نقل‌قول به موجودیت تبدیل می‌شوند.

    <a href="x">تست & آزمون</a>

    نتیجه: &lt;a href=&quot;x&quot;&gt;تست &amp; آزمون&lt;/a&gt;

  • خواندن نشانی کدگذاری‌شده

    نشانی‌ای که در نوار مرورگر به شکل درصدی دیده می‌شود، دوباره به فارسی خوانا برمی‌گردد.

    %D8%B3%D9%84%D8%A7%D9%85

    نتیجه: سلام

اشتباه‌های رایج

  • استفاده از «URL کامل» برای مقدار یک پارامتر: این حالت نویسه‌هایی مثل & و = و / را نگه می‌دارد چون بخشی از ساختار نشانی‌اند. برای مقدار پارامتر «مؤلفه‌ی URL» را بردارید.
  • دو بار escape کردن: اگر متن از قبل escape شده و دوباره همین کار را بکنید، مثلاً &amp;amp; می‌سازید. پیش از تبدیل ببینید متن در چه وضعی است.
  • تکیه بر escape دستی SQL به‌جای پارامتر: دو برابر کردن آپاستروف برای آزمایش سریع خوب است، اما در برنامه همیشه از کوئری پارامتری استفاده کنید.
  • انتظار اینکه escape HTML متن را برای همه‌ی جاها امن کند: درون ویژگی‌های رویدادی یا کد جاوااسکریپت داخل صفحه قاعده‌ها فرق می‌کنند.

چرا هر قالب escape جدا دارد؟

هر قالب نویسه‌هایی را برای ساختار خودش رزرو کرده است. در رشته‌ی جاوااسکریپت نقل‌قول پایان رشته است، در HTML علامت < شروع برچسب و در نشانی وب علامت & جداکننده‌ی پارامترهاست. escape همین نویسه‌ها را به شکلی می‌نویسد که خواننده‌ی آن قالب آن‌ها را جزئی از داده بداند، نه بخشی از ساختار.

برای همین متنی که برای HTML امن شده، در SQL امن نیست و برعکس. قاعده‌ی ساده این است: درست پیش از قرار دادن داده در هر قالب، escape همان قالب را اعمال کنید.

پرسش‌های متداول

تفاوت «مؤلفه‌ی URL» و «URL کامل» چیست؟
مؤلفه‌ی URL (encodeURIComponent) همه‌ی نویسه‌های خاص از جمله / ? & = را کدگذاری می‌کند و برای مقدار پارامتر مناسب است؛ URL کامل (encodeURI) ساختار آدرس را نگه می‌دارد.
رمزگشایی HTML امن است؟
بله. موجودیت‌ها فقط با یک جدول داخلی و در یک مرحله برگردانده می‌شوند؛ «&amp;lt;» می‌شود «&lt;» و هیچ HTML ای ساخته یا اجرا نمی‌شود.
گزینه‌ی «نویسه‌های غیر ASCII» برای چیست؟
در حالت JavaScript و JSON، هر نویسه‌ی فارسی یا ایموجی به شکل \uXXXX نوشته می‌شود تا متن فقط شامل نویسه‌های ASCII باشد.

ابزارهای مرتبط