Encode & Decode URL

URL hanya boleh mengandungi set aksara ASCII yang terhad. RFC 3986, spesifikasi sintaks URI tahun 2005, membahagikannya kepada dua kumpulan. Aksara tidak terpelihara (unreserved), iaitu A–Z, a–z, 0–9 dan empat tanda - . _ ~, tidak perlu dikodkan. Aksara terpelihara (reserved) pula mempunyai fungsi: pembatas am : / ? # [ ] @ memisahkan skema, hos, laluan, pertanyaan dan serpihan, manakala sub-pembatas ! $ & ' ( ) * + , ; = memisahkan item di dalamnya, seperti & dan = dalam rentetan pertanyaan. Semua aksara lain, dan mana-mana aksara terpelihara yang digunakan sebagai data biasa, mesti dikodkan dengan kod peratus.

Pengekodan peratus menulis satu bait sebagai % diikuti dua digit heksadesimal. Teks ditukar dahulu kepada UTF-8, jadi ruang menjadi %20, é (dua bait) menjadi %C3%A9 dan emoji menjadi empat kumpulan %XX. Itulah sebabnya carian "café & bar" menjadi caf%C3%A9%20%26%20bar dalam pautan: & dikodkan supaya pelayan tidak menganggapnya sebagai permulaan parameter baharu.

encodeURIComponent ialah pilihan yang betul untuk satu bahagian, seperti nilai pertanyaan, segmen laluan atau URL ubah hala yang dihantar sebagai parameter. Ia melepaskan semua aksara kecuali aksara tidak terpelihara dan ! ' ( ) *, yang dibiarkan oleh JavaScript atas sebab sejarah. encodeURI (URL penuh) menganggap inputnya sudah menjadi alamat lengkap dan mengekalkan aksara terpelihara, jadi https://example.com/a b?q=1 hanya dikodkan pada ruangnya. Menggunakan encodeURI pada nilai parameter ialah pepijat klasik: & atau # dalam nilai itu akan kekal dan merosakkan URL.

Nyahkod membalikkan kedua-dua fungsi. Borang HTML yang dihantar dengan GET menggunakan format application/x-www-form-urlencoded yang lebih lama, dengan ruang ditulis sebagai + dan bukan %20; biarkan Anggap + sebagai ruang ditandakan untuk kes itu, dan nyahtandakannya apabila tanda tambah literal penting, seperti dalam nombor telefon. Jika input mengandungi % yang tidak diikuti dua digit heksa, atau bait yang bukan UTF-8 sah, penyahkodan gagal dengan mesej yang jelas dan bukan meneka. Apabila teks mengandungi rentetan pertanyaan, parameternya dipaparkan dalam keadaan dinyahkod dalam jadual di bawah alat ini. Untuk data binari dalam URL, Base64url ialah alternatif biasa.