Encode & Decode URL

URL hanya boleh berisi sekumpulan karakter ASCII yang terbatas. RFC 3986, spesifikasi sintaks URI tahun 2005, membaginya menjadi dua kelompok. Karakter unreserved, yaitu A–Z, a–z, 0–9, dan empat tanda - . _ ~, tidak pernah perlu di-encode. Karakter reserved memiliki tugas: pembatas umum : / ? # [ ] @ memisahkan skema, host, path, query, dan fragmen, sedangkan sub-pembatas ! $ & ' ( ) * + , ; = memisahkan item di dalamnya, seperti & dan = dalam query string. Semua karakter lain, serta karakter reserved yang dipakai sebagai data biasa, harus di-percent-encode.

Percent-encoding menuliskan satu byte sebagai % diikuti dua digit heksadesimal. Teks terlebih dahulu diubah menjadi UTF-8, sehingga spasi menjadi %20, é (dua byte) menjadi %C3%A9, dan emoji menjadi empat kelompok %XX. Itulah sebabnya pencarian "café & bar" muncul di tautan sebagai caf%C3%A9%20%26%20bar: tanda & di-encode agar server tidak membacanya sebagai awal parameter baru.

encodeURIComponent adalah pilihan yang tepat untuk satu bagian, seperti nilai query, segmen path, atau URL redirect yang dikirim sebagai parameter. Fungsi ini meng-escape semuanya kecuali karakter unreserved dan ! ' ( ) *, yang dibiarkan JavaScript karena alasan historis. encodeURI (seluruh URL) menganggap inputnya sudah berupa alamat lengkap dan membiarkan karakter reserved tetap utuh, sehingga pada https://example.com/a b?q=1 hanya spasinya yang di-encode. Memakai encodeURI pada nilai parameter adalah bug klasik: & atau # di dalam nilai akan lolos dan merusak URL.

Decode membalik kedua fungsi tersebut. Formulir HTML yang dikirim dengan GET memakai format lama application/x-www-form-urlencoded, yang menuliskan spasi sebagai + alih-alih %20; biarkan Perlakukan + sebagai spasi tercentang untuk input seperti itu, dan hapus centangnya jika tanda plus harfiah penting, misalnya pada nomor telepon. Jika input berisi % yang tidak diikuti dua digit hex, atau byte yang bukan UTF-8 valid, decoding gagal dengan pesan yang jelas alih-alih menebak. Jika teks berisi query string, parameternya ditampilkan dalam bentuk ter-decode di tabel di bawah alat. Untuk data biner di URL, Base64url adalah alternatif yang umum.