انکود و دیکد URL

یک URL فقط می‌تواند شامل مجموعه‌ای محدود از نویسه‌های ASCII باشد. RFC 3986، مشخصات سال 2005 برای نحو URI، این نویسه‌ها را به دو گروه تقسیم می‌کند. نویسه‌های رزرو‌نشده (unreserved) یعنی A–Z، a–z، 0–9 و چهار علامت - . _ ~ هرگز نیازی به کدگذاری ندارند. نویسه‌های رزروشده (reserved) نقش مشخصی دارند: جداکننده‌های عمومی : / ? # [ ] @ طرح، میزبان، مسیر، کوئری و بخش (fragment) را از هم جدا می‌کنند و جداکننده‌های فرعی ! $ & ' ( ) * + , ; = موارد داخل آن‌ها را جدا می‌کنند، همان‌طور که & و = در رشتهٔ کوئری عمل می‌کنند. هر نویسهٔ دیگری، و هر نویسهٔ رزروشده‌ای که به‌عنوان داده معمولی به کار رفته باشد، باید با درصدکدگذاری (percent-encoding) نوشته شود.

درصدکدگذاری هر بایت را به‌صورت % و پس از آن دو رقم شانزدهی می‌نویسد. متن ابتدا به UTF-8 تبدیل می‌شود، بنابراین فاصله به %20، نویسهٔ é (دو بایت) به %C3%A9 و یک ایموجی به چهار گروه %XX تبدیل می‌شود. به همین دلیل جست‌وجوی «café & bar» در لینک به شکل caf%C3%A9%20%26%20bar درمی‌آید: نویسهٔ & کدگذاری می‌شود تا سرور آن را آغاز پارامتر جدید نپندارد.

encodeURIComponent برای یک بخش مجزا، مانند مقدار کوئری، یک قطعهٔ مسیر یا نشانی بازگشتی که به‌عنوان پارامتر ارسال می‌شود، انتخاب درست است. این تابع همه‌چیز را به‌جز نویسه‌های رزرو‌نشده و ! ' ( ) * کدگذاری می‌کند؛ این نویسه‌ها را جاوااسکریپت به دلایل تاریخی دست‌نخورده می‌گذارد. encodeURI (کل URL) فرض می‌کند ورودی یک نشانی کامل است و نویسه‌های رزروشده را حفظ می‌کند، بنابراین در https://example.com/a b?q=1 فقط فاصله کدگذاری می‌شود. استفاده از encodeURI برای مقدار یک پارامتر خطایی کلاسیک است: & یا # درون مقدار باقی می‌ماند و URL را خراب می‌کند.

رمزگشایی هر دو تابع را برعکس می‌کند. فرم‌های HTML که با GET ارسال می‌شوند از قالب قدیمی‌تر application/x-www-form-urlencoded استفاده می‌کنند که در آن فاصله به‌جای %20 به‌صورت + نوشته می‌شود؛ برای این موارد گزینهٔ Treat + as a space را فعال نگه دارید و وقتی علامت مثبت واقعی اهمیت دارد، مثلاً در شمارهٔ تلفن، آن را غیرفعال کنید. اگر ورودی شامل % بدون دو رقم شانزدهی بعد از آن یا بایت‌هایی نامعتبر در UTF-8 باشد، رمزگشایی به‌جای حدس زدن با یک پیام روشن شکست می‌خورد. وقتی متن شامل رشتهٔ کوئری باشد، پارامترهای آن رمزگشایی‌شده در جدولی زیر ابزار نمایش داده می‌شوند. برای داده‌های باینری در URL، Base64url جایگزین معمول است.