عملکرد و کاربرد ابزار انکودر/دیکودر URL و کدهای معادل HTML
این ابزار به توسعهدهندگان، ویراستاران محتوا، کارشناسان پشتیبانی و تمامی کاربران کمک میکند تا متون خود را برای استفاده در ساختار وب آمادهسازی کنند. با استفاده از این ابزار میتوانید متون را برای استفاده در URLها رمزگذاری (Encode) یا رمزگشایی (Decode) کنید و یا کاراکترهای خاص را به کدهای معادل HTML تبدیل (Escape) یا از این حالت خارج (Unescape) نمایید.
عملیات پردازش متون به طور کامل در مرورگر کاربر انجام میشود و هیچ اطلاعاتی به سرورهای BroBroGo آپلود نخواهد شد. این ابزار امکاناتی نظیر بارگذاری متن نمونه، پاک کردن سریع فیلدها و انتقال متن خروجی به فیلد ورودی را جهت تسهیل فرآیند کار فراهم کرده است. حداکثر طول مجاز برای متن ورودی ۲,۰۰۰,۰۰۰ کاراکتر است.
تفاوت رمزگذاری بخش مجزا (Component) و نشانی کامل (Full URL)
در استاندارد وب، کاراکترهای خاصی برای جداسازی بخشهای مختلف یک نشانی اینترنتی تعریف شدهاند. بسته به اینکه قصد دارید یک آدرس کامل را انکود کنید یا تنها یک مقدار خاص (مانند پارامترهای کوئری) را درون آن قرار دهید، باید محدوده مناسب را انتخاب کنید:
- بخش مجزا (Component): این حالت از تابع
encodeURIComponentبرای رمزگذاری وdecodeURIComponentبرای رمزگشایی استفاده میکند. این گزینه تمامی کاراکترهای خاص از جمله/،:،?،&و=را به کدهای درصد تبدیل میکند. استفاده از این حالت برای مقادیر کوئری، بخشهای مسیر یا مقادیر فرمها ضروری است تا ساختار کلی URL دچار اختلال نشود. - نشانی کامل (Full URL): این حالت از تابع
encodeURIبرای رمزگذاری وdecodeURIبرای رمزگشایی استفاده میکند. در این حالت، کاراکترهای ساختاری نشانی اینترنتی مانند:،/،?،&و=بدون تغییر و خوانا باقی میمانند تا ساختار کلی یک URL کامل حفظ شود.
تبدیل کاراکترها به کدهای معادل HTML (HTML Entity Escaping)
هنگام قرار دادن متون در صفحات وب، برخی کاراکترها مانند <، >، & و علامتهای نقلقول به عنوان دستورات ساختاری HTML تفسیر میشوند. برای جلوگیری از تداخل این کاراکترها با کدهای صفحه و نمایش صحیح آنها به کاربر، باید این کاراکترها به کدهای معادل (Entities) تبدیل شوند.
این ابزار در حالت کدهای معادل HTML (Entities)، کاراکترهای خاص و متون غیر اسکی را به معادلهای استاندارد آنها تبدیل میکند تا قرار دادن آنها در متون یا ویژگیهای HTML بدون مشکل انجام شود. لازم به ذکر است که فرآیند تبدیل کاراکترها به کدهای معادل HTML (Escaping) صرفاً جهت نمایش صحیح متون و سازگاری با ساختار وب است و نباید به عنوان جایگزینی برای فرآیندهای امنیتی پاکسازی دادهها (Sanitization) در سمت سرور در نظر گرفته شود. با انتخاب حالت کدهای معادل HTML، کنترلهای مربوط به محدوده URL به طور خودکار پنهان میشوند.
کدهای درصد در URL و الزامات توالی UTF-8
در ساختار URL، کاراکترهای غیر اسکی و کاراکترهای خاص با استفاده از سیستم رمزگذاری درصد (Percent Encoding) نمایش داده میشوند. در این سیستم، هر کاراکتر ابتدا به بایتهای معادل خود در استاندارد UTF-8 تبدیل شده و سپس هر بایت به صورت یک علامت درصد به همراه دو عدد در مبنای شانزده (Hexadecimal) نوشته میشود.
برای رمزگشایی موفقیتآمیز یک URL، کدهای درصد موجود در متن ورودی باید توالیهای کامل و معتبری از استاندارد UTF-8 را تشکیل دهند. اگر یک توالی به صورت ناقص یا خراب وارد شود (مانند %E0%A4%A)، ابزار قادر به رمزگشایی آن نخواهد بود و با خطا مواجه خواهد شد.
راهنمای خطاها و پیامهای سیستم
این ابزار در شرایط مختلف پیامها و خطاهای زیر را به کاربر نمایش میدهد:
- ابتدا متنی را در بخش ورودی وارد کنید.: این پیام زمانی نمایش داده میشود که بدون وارد کردن متن در کادر ورودی، اقدام به اجرای عملیات کنید.
- این ورودی برای این ابزار بسیار بزرگ است. طول آن را زیر
{max}کاراکتر نگه دارید.: در صورتی که حجم متن ورودی از حد مجاز ۲,۰۰۰,۰۰۰ کاراکتر فراتر رود، این خطا نمایش داده میشود. - این متن نشانی اینترنتی دارای یک کد درصد ناقص یا خراب است.: این خطا زمانی رخ میدهد که توالی کدهای درصد در فرآیند رمزگشایی URL نامعتبر یا ناقص باشد.
- این تبدیل بیش از حد طول کشید. از ورودی کوچکتری استفاده کنید.: اگر پردازش متن ورودی به دلیل حجم یا پیچیدگی بیش از حد زمانبر شود، این پیام نمایش داده میشود.
- امکان تبدیل این ورودی وجود نداشت.: در صورت بروز هرگونه خطای پیشبینینشده دیگر در فرآیند تبدیل، این پیام نشان داده میشود.
- ورودی و خروجی پاک شدند.: پس از کلیک بر روی دکمه پاک کردن، این پیام جهت تایید تخلیه فیلدها نمایش داده میشود.
- خروجی به بخش ورودی منتقل شد.: این پیام پس از جابجایی متن خروجی به کادر ورودی نمایش داده میشود.
- نمونه بارگذاری شد.: پس از کلیک بر روی دکمه بارگذاری نمونه، این پیام نمایش داده میشود.
پرسشهای متداول
آیا باید گزینه URL Component را انتخاب کنم یا Full URL؟
برای مقادیر کوئری، بخشهای مسیر یا مقادیر فرم از گزینه Component استفاده کنید. زمانی که میخواهید کاراکترهایی مانند :، /، ?، & و = خوانا باقی بمانند، از گزینه Full URL استفاده کنید.
تبدیل کدهای معادل HTML (HTML Entity Escaping) چه تغییراتی ایجاد میکند؟
این ابزار کاراکترهایی مانند <، >، &، علامتهای نقلقول و متون غیر اسکی را به کدهای معادل (Entities) تبدیل میکند تا بتوان آنها را به صورت ایمن در متون یا ویژگیهای HTML قرار داد.
چرا رمزگشایی نشانی اینترنتی گاهی اوقات با خطا مواجه میشود؟
کدهای درصد (Percent Escapes) باید توالیهای معتبر UTF-8 باشند. یک توالی ناقص مانند %E0%A4%A را نمیتوان بدون حدس زدن رمزگشایی کرد.
آیا اطلاعات وارد شده در این ابزار ذخیره یا ارسال میشوند؟
خیر، متون URL و HTML شما به طور کامل در مرورگرتان تبدیل میشوند و هیچ اطلاعاتی در BroBroGo آپلود نمیشود.