Mã hóa & giải mã URL

Một URL chỉ được chứa một tập ký tự ASCII giới hạn. RFC 3986, đặc tả cú pháp URI năm 2005, chia chúng thành hai nhóm. Các ký tự không dành riêng (unreserved) gồm A–Z, a–z, 0–9 và bốn dấu - . _ ~, không bao giờ cần mã hóa. Các ký tự dành riêng (reserved) có nhiệm vụ riêng: các dấu phân cách chung : / ? # [ ] @ ngăn cách giao thức, máy chủ, đường dẫn, truy vấn và đoạn (fragment), còn các dấu phân cách phụ ! $ & ' ( ) * + , ; = ngăn cách các mục bên trong chúng, như & và = trong chuỗi truy vấn. Mọi ký tự còn lại, cũng như ký tự dành riêng được dùng như dữ liệu thông thường, đều phải được mã hóa phần trăm.

Mã hóa phần trăm viết một byte thành % kèm hai chữ số thập lục phân. Văn bản trước tiên được chuyển sang UTF-8, nên dấu cách thành %20, chữ é (hai byte) thành %C3%A9 và một emoji thành bốn nhóm %XX. Vì vậy, khi tìm kiếm "café & bar", liên kết sẽ có dạng caf%C3%A9%20%26%20bar: dấu & được mã hóa để máy chủ không hiểu nhầm là phần bắt đầu của một tham số mới.

encodeURIComponent là lựa chọn phù hợp cho một phần riêng lẻ, chẳng hạn giá trị truy vấn, một đoạn đường dẫn hoặc URL chuyển hướng truyền làm tham số. Hàm này mã hóa mọi ký tự trừ các ký tự không dành riêng và ! ' ( ) *, vốn được JavaScript giữ nguyên vì lý do lịch sử. encodeURI (whole URL) giả định đầu vào đã là một địa chỉ hoàn chỉnh và giữ nguyên các ký tự dành riêng, nên với https://example.com/a b?q=1 chỉ dấu cách được mã hóa. Dùng encodeURI cho giá trị tham số là lỗi kinh điển: dấu & hoặc # trong giá trị vẫn còn nguyên và làm hỏng URL.

Decode đảo ngược cả hai hàm trên. Biểu mẫu HTML gửi bằng GET dùng định dạng application/x-www-form-urlencoded cũ hơn, trong đó dấu cách được viết là + thay vì %20; hãy giữ nguyên tùy chọn Treat + as a space được chọn cho các trường hợp đó, và bỏ chọn khi dấu cộng có ý nghĩa thực sự, ví dụ trong số điện thoại. Nếu đầu vào có dấu % không theo sau bởi hai chữ số thập lục phân, hoặc có byte không phải UTF-8 hợp lệ, việc giải mã sẽ báo lỗi rõ ràng thay vì đoán. Khi văn bản chứa chuỗi truy vấn, các tham số của nó được giải mã và hiển thị trong bảng bên dưới công cụ. Với dữ liệu nhị phân trong URL, Base64url là giải pháp thay thế thường dùng.