URL Kodlama ve Çözme

Nasıl çalışır

Yüzde kodlaması bir baytı % ve iki onaltılık hane ile yazar. Metin önce UTF-8'e çevrilir; bu yüzden tek bir harf birkaç kaçış dizisi olabilir: ş için %C5%9F. URL'de güvenli olan karakterler olduğu gibi kalır. RFC 3986 her zaman güvenli kümeye "ayrılmamış" (unreserved) der: harfler, rakamlar ve - . _ ~.

Aracın üç kodlama türü var ve doğrusu neyi kodladığınıza bağlı.

Form türü encodeURIComponent'ten daha sıkıdır: ~ ! ' ( ) kodlanır ve düz bir + %2B olur. Satır sonu URLSearchParams gibi %0A yazılır; HTML formu gönderiminin kullanacağı CRLF taklit edilmez. Sıkı seçenek bileşen türüne ! ' ( ) * karakterlerini ekler.

Çözme

Çözme kaçışları geri alır ve baytları UTF-8 olarak okur. Bileşen çözmede + olduğu gibi kalır; form çözmede önce boşluğa dönüşür. Çözme ayrılmış karakterleri de açığa çıkarır: %2F / olur, yani sonuç tekrar kodlanmadan bir adrese konursa yapısı değişebilir.

Sıkı çözme, iki hanesiz % için ve geçerli UTF-8 olmayan baytlar için hata verir. Hoşgörülü çözme geçerli her parçayı çözer, geçersiz olanları yazıldığı gibi bırakır ve sayar.

Parça görünümü

Girdiğiniz metin bir http ya da https adresiyse, bir tablo parçaları WHATWG URL ayrıştırıcısının gördüğü gibi gösterir: şema, ana makine (ASCII dışı alan adı punycode olarak görünür), port (şemanın varsayılanıysa boş), çözülmüş yol, # parçası ve & ile bölünmüş, + işareti boşluk okunan ad ve değer çiftleri. Adreste kullanıcı adı ya da parola varsa işaretlenir. Hiçbir şey çekilmez.

Örnekler

Sıkı seçenek açıkken bileşen türünde !'()*~ %21%27%28%29%2A~ olur.

Bir adres, iki yoldan (yukarıdaki kurallardan türetilmiştir): https://ornek.com/a b?q=ş&x=1#top metni tam adres olarak kodlanınca https://ornek.com/a%20b?q=%C5%9F&x=1#top olur ve hâlâ adres olarak çalışır. Bileşen olarak kodlanınca https%3A%2F%2Fornek.com%2Fa%20b%3Fq%3D%C5%9F%26x%3D1%23top çıkar; bu yalnızca adresin tamamı başka bir adresin sorgu değeriyse (örneğin bir yönlendirme parametresi) doğrudur.

Çözme. %C5%9F%C4%B1%F0%9F%98%80 şı😀 olarak çözülür. a+b%2Bc dizesi bileşen olarak a+b+c, form verisi olarak a b+c verir. Hoşgörülü modda a%zz%41%E0%A4%A b girdisi 4 geçersiz diziyle a%zzA%E0%A4%A b olur, 100% 1 geçersiz diziyle 100% kalır, %FF%C5%9F ise 1 geçersiz diziyle %FFş verir.

Parçalar. https://example.com:8443/a%20b/%C5%9F?x=1&y=%C5%9F+z&x=2&flag&=v#sec%20tion adresi için tablo şunu gösterir: ana makine example.com, port 8443, yol /a b/ş, parça sec tion ve parametreler x = 1, y = ş z, x = 2, flag (değersiz) ve v değerli, adsız bir parametre. https://münchen.de:443/ adresinde ana makine xn--mnchen-3ya.de olur ve port şemanın varsayılanıdır.

Dikkat edilecekler

• Bileşen türünü bütün adrese değil, parçalara uygulayın. Adresi kodlanmış parçalardan kurun; tam adres türünü yalnızca içinde kodlanmamış özel karakterler bulunan, bütün bir adresiniz varsa kullanın.
• Bir kez kodlayın. Beklediğiniz yerde %25 görüyorsanız girdi zaten kodluydu. Önce çözün ya da sonraki sistemin ona ne yaptığına bakın.
• Türü okuyan tarafa göre seçin. Bir form ayrıştırıcısı sorguda + işaretini boşluk sayar. Verinizdeki gerçek artı %2B olmalıdır; bunu bileşen ve form türleri üretir (tam adres türü + işaretini olduğu gibi bırakır).
• Değerin içindeki # ve & kodlanmalıdır; yoksa değeri ya da sorguyu bitirirler.
• Çözülen metin her zaman URL için güvenli değildir. %2F ve %3F gibi ayrılmış kaçışlar da çözülür; sonucu bir adrese geri koyarsanız yapı değişebilir.
• Tek başına vekil karakterler reddedilir. Yarım bir emoji içeren metin UTF-8 ile yazılamaz; sessizce değiştirmek yerine hata verilir.
• Adreste kimlik bilgisi. Parça görünümü, bir bağlantı kullanıcı adı ya da parola taşıyorsa uyarır: bunlar bağlantıyla birlikte gider ve bağlantıyı gören herkese açıktır.
• Sınır. 500.000 karaktere kadar metin; araç girdiğiniz adresi açmaz, çekmez ve göndermez.