Bộ mã hóa Thành phần URI

Cái gì được thoát

Bộ mã hóa này tuân theo RFC 3986: chỉ tập không dành riêng được giữ nguyên, A-Z a-z 0-9 - _ . ~. Mọi thứ khác trở thành UTF-8 mã hóa phần trăm, gồm cả khoảng trắng và các ký tự phân tách phụ ! * ' ( ) mà encodeURIComponent của JavaScript sẽ để yên.

Thành phần so với URI đầy đủ

Bộ mã hóa này nghiêm ngặt hơn encodeURI, vốn để yên : / ? # [ ] @ ! $ & ' ( ) * + , ; = vì các ký tự đó mang tính cấu trúc trong một URL. Với một giá trị bạn nối vào chuỗi truy vấn, bạn muốn dạng nghiêm ngặt, và đó chính xác là thứ công cụ này tạo ra: nó thậm chí thoát cả ! ' ( ) *, đi xa hơn một bước so với encodeURIComponent của JavaScript.

const url = `/search?q=${encodeURIComponent(userInput)}`;

Cạm bẫy thường gặp

• Mã hóa hai lần: mã hóa thứ đã được mã hóa cho bạn %2520 thay vì %20. Luôn giải mã trước nếu bạn không chắc về nguồn.
• Dấu cộng trong biểu mẫu: việc gửi biểu mẫu HTML mã hóa khoảng trắng thành +, không phải %20. Các bộ giải mã tuân thủ RFC 3986 nghiêm ngặt (gồm cả bộ này) sẽ không biến + trở lại thành khoảng trắng. Hãy dùng một bộ giải mã hiểu biểu mẫu cho những trường hợp đó.
• Dấu phân tách đường dẫn: mã hóa / ở đây biến nó thành %2F. Nếu bạn muốn giữ cấu trúc đường dẫn thật, hãy nối các đoạn trước rồi mã hóa từng đoạn riêng.