BAB 38: URL Encoding
Cara URL mengkodekan karakter khusus dan mengapa ini penting untuk web.
Di bab sebelumnya kita bicara tentang charset, bagaimana browser mengetahui encoding yang digunakan sebuah file HTML. Charset memastikan teks di dalam halaman ditampilkan dengan benar. Tapi ada satu tempat lagi di mana karakter perlu diperlakukan secara hati-hati: URL.
URL punya aturan tersendiri tentang karakter mana yang boleh muncul dan mana yang harus diubah terlebih dahulu. Aturan inilah yang disebut URL encoding, atau lebih tepatnya, percent-encoding.
Mengapa URL Tidak Bisa Sembarangan
Sebuah URL adalah teks biasa, tapi bukan sembarang teks. Browser menginterpretasi karakter-karakter tertentu di dalam URL sebagai bagian dari struktur, bukan sebagai data. Karakter ? menandai awal query string. Karakter & memisahkan satu parameter dari parameter berikutnya. Karakter # menandai fragment identifier.
Masalah muncul ketika data yang ingin dikirim via URL kebetulan mengandung karakter-karakter struktural tersebut. Misalnya, nama pengguna "Abd. Asis & Rekan" dikirim sebagai parameter pencarian:
https://toko.contoh/cari?nama=Abd. Asis & Rekan
Browser tidak akan bisa membaca ini dengan benar. Karakter & di tengah nilai akan diinterpretasi sebagai pemisah parameter baru, bukan bagian dari nama. Hasilnya: server menerima dua parameter terpisah (nama=Abd. Asis dan Rekan=) alih-alih satu nilai yang utuh.
URL encoding hadir untuk mengatasi ambiguitas ini, dengan cara mengubah karakter bermasalah menjadi representasi yang aman sebelum dimasukkan ke dalam URL.
Format Percent-Encoding
Mekanismenya sederhana: setiap karakter yang perlu di-encode diganti dengan tanda persen (%) diikuti dua digit heksadesimal yang merepresentasikan nilai byte karakter tersebut.
Spasi, misalnya, memiliki nilai ASCII 32, yang dalam heksadesimal adalah 20. Maka spasi di-encode menjadi %20.
Sebelum: Abd. Asis
Sesudah: Abd.%20Asis
Karakter & memiliki nilai ASCII 38, atau 26 dalam heksadesimal:
Sebelum: Abd. Asis & Rekan
Sesudah: Abd.%20Asis%20%26%20Rekan
URL yang tadi bermasalah menjadi:
https://toko.contoh/cari?nama=Abd.%20Asis%20%26%20Rekan
Sekarang server menerima satu parameter nama dengan nilai yang tepat: Abd. Asis & Rekan.
Karakter yang Perlu Di-Encode
Tidak semua karakter perlu di-encode. Karakter yang aman disebut unreserved characters: huruf alfanumerik (A–Z, a–z, 0–9) dan empat simbol: -, _, ., ~. Karakter-karakter ini boleh muncul di URL apa adanya.
Semua karakter lain, terutama yang punya makna khusus dalam struktur URL, harus di-encode ketika digunakan sebagai data. Berikut beberapa yang paling sering ditemui:
| Karakter | Encoding | Keterangan |
|---|---|---|
| Spasi | %20 | Tidak boleh ada di URL |
# | %23 | Dipakai untuk fragment identifier |
% | %25 | Karakter encoding itu sendiri |
& | %26 | Pemisah parameter query string |
+ | %2B | Di beberapa konteks berarti spasi |
/ | %2F | Pemisah path segment |
= | %3D | Pemisah nama dan nilai parameter |
? | %3F | Menandai awal query string |
@ | %40 | Dipakai dalam URL dengan kredensial |
Encoding Karakter Non-ASCII
Karakter non-ASCII (termasuk huruf beraksara, karakter Asia, dan emoji) tidak bisa langsung dimasukkan ke URL karena URL hanya mendukung karakter ASCII.
Proses encoding-nya dua tahap: pertama karakter dikonversi ke byte menggunakan UTF-8, kemudian setiap byte di-encode ke format %XX.
Karakter © (copyright), misalnya, dalam UTF-8 direpresentasikan sebagai dua byte: 0xC2 dan 0xA9. Maka encoding URL-nya menjadi %C2%A9.
Karakter: ©
UTF-8 bytes: C2 A9
URL encoded: %C2%A9
Nama "Asis" dalam contoh portofolio kita tidak perlu di-encode karena hanya mengandung huruf ASCII. Tapi jika nama file gambar mengandung spasi atau karakter khusus, hal ini langsung relevan, itulah mengapa di Bab 27 kita dianjurkan menggunakan nama file dengan huruf kecil dan tanda hubung saja.
Spasi: %20 atau +?
Ada dua cara spasi direpresentasikan di URL:
%20 adalah encoding standar untuk spasi di semua bagian URL, path, query, dan fragment.
+ adalah encoding alternatif yang hanya berlaku di dalam query string, dan hanya dalam konteks form HTML yang menggunakan method="GET" dengan enctype="application/x-www-form-urlencoded". Ini adalah konvensi lama dari format form HTML, bukan standar URL.
Untuk menulis URL secara manual di atribut href atau action, gunakan %20 untuk spasi, bukan +. Encoding + untuk spasi hanya dihasilkan secara otomatis oleh browser saat mengirimkan data form GET, bukan untuk URL biasa.
URL Encoding di Atribut HTML
Saat kamu menulis atribut href dengan query string secara manual, karakter yang punya makna ganda harus di-encode. Tapi perlu dibedakan: karakter & yang memisahkan parameter URL dalam HTML harus ditulis sebagai entitas HTML &, bukan & biasa.
<!-- portofolio.html -->
<!-- Salah: & mentah di dalam atribut HTML -->
<a href="/cari?kategori=desain&halaman=2">Desain</a>
<!-- Benar: & ditulis sebagai entitas HTML -->
<a href="/cari?kategori=desain&halaman=2">Desain</a>
Ini bukan URL encoding, ini adalah HTML entity encoding. Keduanya berbeda: URL encoding mengamankan karakter dalam konteks URL, sementara HTML entity encoding mengamankan karakter dalam konteks markup HTML. Ketika keduanya bertemu di atribut href, aturan HTML berlaku terlebih dahulu.
Browser cukup toleran dan biasanya memahami keduanya, tapi penulisan & adalah cara yang benar secara standar.
URL Encoding di JavaScript
Ketika membuat URL secara programatik (misalnya dengan JavaScript yang menyusun URL dari input pengguna) tersedia dua fungsi bawaan:
encodeURI() mengasumsikan argumennya adalah URL lengkap. Fungsi ini tidak men-encode karakter struktural URL seperti :, /, ?, #, dan & karena karakter tersebut mungkin memang bagian dari struktur URL.
encodeURIComponent() lebih agresif, ia men-encode semua karakter kecuali unreserved characters. Ini tepat digunakan ketika kamu ingin memasukkan satu nilai sebagai bagian dari parameter query string.
<!-- portofolio.html -->
<script>
// Menyusun URL pencarian dari input pengguna
const kata = "Abd. Asis & Rekan";
const url = "/cari?nama=" + encodeURIComponent(kata);
// Hasil: /cari?nama=Abd.%20Asis%20%26%20Rekan
window.location.href = url;
</script>
Selalu gunakan encodeURIComponent() saat memasukkan nilai yang berasal dari pengguna ke dalam URL. Ini mencegah karakter khusus dalam input pengguna merusak struktur URL yang kamu buat.
Latihan
Praktikkan pemahaman URL encoding di proyek portofolio Abd. Asis:
-
Tambahkan link navigasi di
portofolio.htmlyang menautkan ke halaman kontak dengan parameter query string: nama pengguna dan pesan singkat. Pastikan nilai parameter di-encode dengan benar jika mengandung spasi. -
Periksa link-link di halaman yang mengandung
&dalam query string, apakah sudah ditulis sebagai&di dalam HTML? -
Buka DevTools browser, buka tab Network, lalu klik salah satu link. Perhatikan URL yang benar-benar dikirim ke server di kolom Request URL, bandingkan dengan yang tertulis di HTML.
URL encoding memastikan data yang dikirim melalui URL sampai ke tujuan tanpa distorsi. Sejauh ini kita sudah membahas banyak hal tentang karakter, encoding, dan representasi teks di web. Di bab berikutnya, kita akan bergeser ke topik yang mungkin terasa lebih historis tapi tetap relevan untuk memahami ekosistem web: perbedaan antara HTML5 dan XHTML.