URL Kodlayıcı / Çözücü

URL kodlayıcı, bir URL'de doğrudan kullanılamayan karakterleri yüzde kodlanmış dizilere dönüştürür. URL çözücü bu işlemi tersine çevirerek yüzde kodlanmış metni orijinal karakterlerine geri döndürür. Bu sayfa her iki yönü de, hem tek bir URL bileşeni hem de tam bir URL için destekler.

Araç dört standart JavaScript işlevi kullanır:

• encodeURIComponent — sorgu parametresi değeri gibi tek bir URL bileşenini kodlamak için.
• encodeURI — yapısal anlamı olan : / ? # & = gibi ayrılmış karakterleri koruyarak tam bir URL'yi kodlamak için.
• decodeURIComponent — tek bir URL bileşenini orijinal karakterlerine geri çözmek için.
• decodeURI — ayrılmış karakterlere dokunmadan tam bir URL'yi çözmek için.

Tüm dönüşümler UTF-8 uyumludur; bu sayede aksanlı harfler, emoji'ler ve Latin dışı alfabelere ait karakterler doğru şekilde işlenir. Hiçbir şey yüklenmez, hiçbir şey saklanmaz ve API çağrısı yapılmaz.

URL kodlamanın pratikte nasıl göründüğüne dair birkaç örnek:

• Boşluk %20 olur; örneğin merhaba dünya, merhaba%20d%C3%BCnya şeklinde kodlanır.
• Sorgu değerindeki eğik çizgi %2F olur; a/b parametresi a%2Fb olur.
• Bir değerdeki soru işareti %3F olur; ne? ifadesi ne%3F olur.
• Bir değerdeki & işareti %26 olur ve çevresindeki sorgu dizesinin bozulmasını önler.
• Bir değerdeki kare işareti %23 olur; c# ifadesi c%23 olur.
• ASCII dışı karakterler çok baytlı UTF-8 dizileri kullanır. Örneğin café, caf%C3%A9 olur (é iki UTF-8 baytıdır).
• Emoji'ler de çok baytlı UTF-8 kullanır: 😀, %F0%9F%98%80 olur.

Aracı Çöz moduna alın ve bu kodlanmış dizelerden birini yapıştırarak orijinal metnin tam olarak geri döndüğünü görün.

Doğru modu seçmek önemlidir; zira iki kodlayıcı ayrılmış karakterleri farklı biçimde işler.

Bir URL'ye eklenecek tek bir değeri kodlarken — örneğin sorgu parametresi değeri, yol bölümü veya fragment değeri — Bileşen modunu (encodeURIComponent / decodeURIComponent) kullanın. Bileşen modu ayrılmış karakterleri (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) yüzde kodlamasına çevirerek çevresindeki URL yapısını yanlışlıkla değiştirmelerini önler.

https://ornek.com/yol?sorgu=deger#fragment gibi hazır bir URL'niz varsa ve yalnızca güvensiz karakterleri (boşluklar, ASCII dışı karakterler) kaçırmak istiyorsanız Tam URL modunu (encodeURI / decodeURI) kullanın. Bu mod yapısal ayrılmış karakterlere dokunmaz.

Sık yapılan bir hata, sorgu parametresi olması gereken bir değer üzerinde encodeURI kullanmaktır. Ayrılmış karakterler değişmeden kalır ve çevresindeki URL bozulabilir. Şüphe durumunda her sorgu değerini encodeURIComponent ile kodlayın, ardından URL'yi birleştirin.

Yüzde kodlama (URL kodlama olarak da bilinir), bir URL'de ayrılmış (yapısal anlamı olan) veya hiç izin verilmeyen karakterleri temsil etme yöntemidir. Güvensiz her bayt, yüzde işareti ve iki onaltılık rakamdan oluşan biçimde yazılır — örneğin boşluk için %20, eğik çizgi için %2F veya soru işareti için %3F.

Kodlama karakter düzeyinde değil, bayt düzeyinde çalışır. Modern URL'ler karakterleri önce UTF-8 ile bayta çevirir; bu nedenle tek bir aksanlı harf iki yüzde kodlanmış bayta, bir emoji ise dört bayta dönüşebilir. Bu araç her zaman UTF-8 kullanır, böylece kodlanmış dizeler web'in geri kalanıyla birlikte çalışabilir.

Yüzde kodlama RFC 3986 tarafından tanımlanmıştır. Burada kullanılan yerel JavaScript işlevleri bu belirtimi uygular; bu nedenle herhangi bir modern tarayıcıda encodeURIComponent ile kodlanan değer, decodeURIComponent ile her yerde doğru biçimde çözülebilir.

Bu URL kodlayıcı-çözücü, metni bir URL'ye güvenli biçimde taşımanız veya URL'den almanız gereken her durumda işe yarar. Yaygın senaryolar:

• Sorgu dizesine eklemeden önce metni kodlamak; API isteğine, günlük satırına veya tarayıcı adres çubuğuna yapıştırmadan önce.
• Orijinal değerleri okumak için istek günlüğünden veya analiz dışa aktarımından URL parametrelerini çözmek.
• Uzun kodlanmış bir URL'yi çözerek gerçekte ne iletildiğini kontrol etmek.
• Bir URL'deki özel karakterleri sohbet, belgeleme veya JSON yüküne paylaşmadan önce kaçırmak.
• Yüzde kodlamanın ve UTF-8 bayt dizilerinin karakterlerle nasıl eşlendiğini öğrenmek.

Araç tamamen tarayıcıda çalıştığından, uzak bir hizmete yapıştırmak istemediğiniz hassas URL'ler (dahili bağlantılar, token'lar, imzalı URL'ler) için de uygundur.

URL kodlama ve URL temizleme sıkça karıştırılan iki farklı işlemdir.

URL kodlama (bu araç), karakterleri URL'de güvenli yüzde kodlama biçimine dönüştürür ve geri çevirir. URL yapısı korunur; hiçbir şey eklenmez veya kaldırılmaz.

URL temizleme (ayrı bir araç türü), utm_source, utm_medium, fbclid, gclid gibi izleme parametrelerini URL'den kaldırır; böylece sonuçta elde edilen bağlantı izleme meta verisi içermez. URL temizleme URL'deki parametreleri değiştirir — kodlama bunu yapmaz.

İzleme parametrelerini kaldırmak istiyorsanız özel bir URL temizleyiciye ihtiyacınız vardır. Metni yüzde kodlama biçimine çevirmek veya geri almak istiyorsanız doğru araç budur.