Enkode URL

Rekomendasi Terkait

Kasus penggunaan

• Debugging parameter API: membandingkan output encodeURIComponent dan encodeURI untuk menyelesaikan masalah ketidakcocokan tanda tangan antarmuka
• Dekode log: mendekode konten yang terenkode URL di log secara batch untuk memulihkan teks yang dapat dibaca
• Pembuatan URL: mode Query Only mempertahankan nama kunci dan hanya mengenkode nilai, menghindari kesalahan format saat penggabungan manual
• Pengembangan frontend: penyorotan membantu memahami karakter mana yang di-escape, berguna untuk debugging pengalihan halaman
• Migrasi data: memproses data terenkode URL yang diekspor dari sistem lama secara batch untuk dikonversi ke format baru

Fitur

• Empat mode enkode: beralih antara encodeURIComponent / encodeURI / full / RFC 3986 dengan satu klik, bandingkan perbedaan output secara real-time
• Penyorotan enkode: menyorot karakter %XX yang di-escape secara real-time, penandaan warna kuning keemasan membuat hasil enkode terlihat langsung
• Mode batch: mendukung enkode/dekode batch banyak baris, setiap baris diproses secara independen, ideal untuk log atau data massal
• Mode Query Only: hanya mengenkode bagian nilai parameter URL (setelah tanda sama dengan), membiarkan nama kunci, karakter, dan struktur jalur tidak tersentuh
• Debounce real-time: otomatis mengenkode/mendekode dalam 300ms, tidak perlu klik tombol, hasil muncul saat mengetik
• Penghitung karakter: menampilkan jumlah karakter yang dimasukkan secara real-time, berguna untuk memeriksa batas panjang parameter API

Cara Penggunaan

1. Masukkan atau tempel URL atau teks yang ingin dienkode/didekode
2. Pilih arah enkode (Enkode/Dekode) dan mode (Component / URI / full / RFC 3986)
3. Aktifkan mode batch untuk data banyak baris atau Query Only untuk mengenkode hanya nilai parameter
4. Periksa hasil yang disorot dan salin string terenkode untuk digunakan dalam panggilan API atau pembuatan URL

Pertanyaan Umum

Apa itu enkode URL?

术语表

Persen-encoding (Percent-encoding)

Nama resmi untuk enkode URL, metode pengkodean yang merepresentasikan karakter dengan % diikuti oleh dua digit heksadesimal. Misalnya, spasi menjadi %20, karakter Cina '中' menjadi %E4%B8%AD.Wikipedia - Percent-encoding

encodeURIComponent

Fungsi bawaan JavaScript, mengenkode semua karakter kecuali A-Z a-z 0-9 - _ . ! ~ * ' ( ). Paling sering digunakan untuk mengenkode nilai parameter query individu.

encodeURI

Fungsi bawaan JavaScript, mempertahankan karakter struktural URL (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) dan hanya mengenkode karakter yang benar-benar perlu dienkode. Digunakan untuk mengenkode URL lengkap.

RFC 3986

Standar IETF terbaru untuk sintaks umum URI (2005), mendefinisikan aturan enkode URL dan mengklasifikasikan tilde ~ sebagai karakter tidak dipesan (tidak perlu enkode). Menggantikan RFC 2396 dan RFC 1738 lama.RFC 3986

Karakter Dipesan (Reserved Characters)

Karakter dengan makna khusus di URL, seperti : / ? # [ ] @ ! $ & ' ( ) * + , ; =. Karakter ini harus dienkode ketika digunakan sebagai data, tetapi tidak di posisi strukturalnya.

Karakter Tidak Dipesan (Unreserved Characters)

Karakter aman yang dapat digunakan di posisi URL mana pun tanpa enkode, termasuk A-Z, a-z, 0-9, -, _, ., ~ (menurut RFC 3986).

Query String

Bagian dari URL setelah ?, terdiri dari pasangan key=value yang dipisahkan oleh &. Misalnya, di ?name=张三&age=20, name=张三 dan age=20 adalah dua parameter.

URLSearchParams

API yang disediakan oleh browser modern untuk membuat dan mengurai query string URL dengan mudah, dengan penanganan enkode dan dekode otomatis. Lebih aman dan andal daripada penggabungan string manual.

application/x-www-form-urlencoded

Format pengiriman default untuk form HTML, di mana spasi dienkode sebagai + bukan %20, agak berbeda dari encodeURIComponent. Framework server biasanya menangani kedua format secara otomatis.

Pengkodean UTF-8

Metode pengkodean karakter standar untuk web. Saat mengenkode URL, karakter non-ASCII (seperti Cina, emoji) terlebih dahulu dikonversi ke urutan byte UTF-8, kemudian setiap byte dienkode dalam format %XX.

Perbandingan Karakter yang Di-escape di 4 Mode Enkode

Referensi Cepat Karakter Khusus URL yang Umum

Code Examples

// encodeURIComponent: mengenkode nilai parameter individu (paling sering digunakan)
const param = encodeURIComponent('张三&李四');
console.log(param); // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

// encodeURI: mengenkode URL lengkap (mempertahankan karakter struktural :/?#&=)
const url = encodeURI('https://example.com/search?q=halo dunia');
console.log(url);

// Dekode
const decoded = decodeURIComponent(param);
console.log(decoded); // 张三&李四

// Kompatibel RFC 3986 (~ tidak terenkode)
function rfc3986Encode(str) {
  return encodeURIComponent(str).replace(/[!'()*]/g, c => '%' + c.charCodeAt(0).toString(16).toUpperCase());
}

// API URLSearchParams (cara modern, enkode otomatis)
const params = new URLSearchParams({ name: '张三', city: '北京' });
console.log(params.toString());
// name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC

from urllib.parse import quote, unquote, urlencode, quote_plus

# quote: mirip dengan encodeURIComponent
encoded = quote('张三&李四')
print(encoded)  # %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

# Mode RFC 3986 (~ default tidak terenkode)
print(quote('hello~world'))  # hello~world

# quote_plus: spasi terenkode menjadi + (format form)
print(quote_plus('hello world'))  # hello+world

# Dekode
print(unquote(encoded))  # 张三&李四

# urlencode: membuat query string
params = urlencode({'name': '张三', 'city': '北京'})
print(params)
# name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC

import java.net.URLEncoder;
import java.net.URLDecoder;
import java.net.URI;
import java.nio.charset.StandardCharsets;

public class URLEncodeExample {
    public static void main(String[] args) throws Exception {
        // Enkode URL (URLEncoder - format form, spasi menjadi +)
        String encoded = URLEncoder.encode("张三&李四", "UTF-8");
        System.out.println(encoded);
        // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

        // Dekode
        String decoded = URLDecoder.decode(encoded, "UTF-8");
        System.out.println(decoded); // 张三&李四

        // Membuat URL lengkap (kelas URI menangani enkode secara otomatis)
        URI uri = new URI("https", "example.com", "/search", "q=halo", null);
        System.out.println(uri.toASCIIString());
    }
}

Authoritative References

• ReferenceRFC 3986 - Uniform Resource Identifier (URI): Generic Syntax
• ReferenceRFC 1738 - Uniform Resource Locators (URL)
• ReferenceMDN Web Docs - encodeURIComponent()
• ReferenceMDN Web Docs - encodeURI()
• ReferenceWikipedia - Percent-encoding