URL kodlama ve çözme: %20, + ve %2F örnekleri

Elindeki şeyin değer mi tam adres mi olduğunu belirle

Arama ifadesindeki ve işaretiyle iki sorgu parametresini ayıran ve işareti farklı görevler yapar. Kırmızı & mavi gibi bir ifadeyi doğru kodlamadan adrese eklersen uygulama, ifadenin bir bölümünü tek değerin parçası olarak değil URL yapısı olarak yorumlayabilir. Sonuç görünüşte yakın olsa da sunucuya ulaşan bilgi değişebilir.

KitForma’nın URL kodlayıcısında bileşen modu ve tam URL modu bulunur. Bileşen modu tek sorgu değeri veya yol parçası için uygundur. Tam URL modu eğik çizgi, soru işareti, ve işareti ve kare işareti gibi ayırıcıları korur; bunlardan hangisini metnin gerçek parçası olarak kastettiğini tahmin etmez.

Anlamlı en küçük parçayı kodla

Arama parametresi için önce aranan ifadeyi kodla, sonra sonucu parametre adından sonraya yerleştir. Başka bir sistem, bitmiş adresi farklı bir URL içinde değer olarak göndermeni açıkça istemiyorsa adresin tamamını tek bileşenmiş gibi kodlama. Aksi halde bağlantıyı oluşturan gerekli ayırıcıları da dönüştürmüş olabilirsin.

Sonucu karşılaştırmak için örneğin kodlanmamış kopyasını sakla. Boşluk, aksanlı harf ve ayırıcı noktalama işaretleri yararlı deneme karakterleridir. KitForma tarayıcının UTF-8 yüzde kodlama davranışını kullanır; geçersiz Unicode girişinde sessizce başka metin üretmek yerine hata bildirir. Bu hata, kaynağa dönüp karakterleri denetlemek için bir işarettir.

Değer: red & blue
Bileşen sonucu: red%20%26%20blue
Adres: https://example.com/search?q=red%20%26%20blue

Çözerken artı işaretinin anlamını seç

Çözücü varsayılan olarak + işaretini gerçek artı olarak korur. Artının boşluğu temsil ettiği form tarzı çözmeyi de seçebilirsin. Kararını girdiyi üreten sistemin biçimine göre ver. Kaynağı incelemeden bu ayarı değiştirmek, metindeki gerçek artı işaretini yanlışlıkla boşluğa dönüştürebilir; bu özellikle kısa kodlarda sonucu fark etmeyi zorlaştırır.

Birden fazla parametre içeren tam sorgu dizisinde önce her şeyi çözüp sonra kendin bölmek yerine Sorgu Dizisi Ayrıştırıcıyı kullan. Bu araç form tarzı sorgu davranışını izler ve tekrarlanan anahtarları korur. Böylece aynı ada atanmış birden fazla değerin yalnız sonuncusunu görüp diğerlerini kaçırma riskini azaltırsın.

A+B, gerçek artı seçeneğiyle → A+B
A+B, form tarzı seçenekle → A B
A%2BB, iki seçenekte de → A+B

Beklenen çözme katmanında dur

Yüzde işaretinin kendisi de kodlanabilir. Örneğin %252F bir kez çözüldüğünde %2F, tekrar çözüldüğünde eğik çizgi elde edilir. Bunlar aynı metin değildir ve yol içinde kullanıldığında farklı anlam taşıyabilir. Bir şeyi tekrar tekrar çözmek, genel amaçlı bir temizleme işlemi olarak kullanılmamalıdır.

Değer çözülemiyorsa yarıda kalmış yüzde işareti dizisi veya geçersiz UTF-8 baytları olup olmadığına bak. Değişiklik yapmadan önce orijinal dışa aktarmayla karşılaştır. Araç adresi ziyaret etmez, sitenin varlığını doğrulamaz, zararlı içeriği kaldırmaz veya bağlantının açılmasının güvenli olup olmadığına karar vermez.

Sorgu parametrelerini iki kez kodlamadan oluştur

URLSearchParams içine özgün değeri ver. Boşlukları +, gerçek artı işaretini %2B olarak yazar. Önceden yüzde kodlaması yapılmış değer verirsen yüzde işaretleri tekrar kodlanır; %20, %2520 olur. Hedefte kodların düz metin olarak görünmesinin yaygın nedenlerinden biri budur.

Bir parametre tekrar edebiliyorsa getAll() kullan. Sorguyu hemen nesneye çevirmek tekrarlanan değerleri kaybettirebilir. Aşağıdaki örnek iki tag değerini de tutar ve q değerini özgün metin olarak geri okur.

const params = new URLSearchParams();
params.set("q", "red & blue");
params.append("tag", "a+b");
params.append("tag", "café");
params.toString(); // q=red+%26+blue&tag=a%2Bb&tag=caf%C3%A9
params.get("q"); // red & blue
params.getAll("tag"); // ["a+b", "café"]

MDN: URLSearchParams and percent encoding ↗

Sonucu kullanılacağı yerde doğrula

Kodlama araçları metni cihazında işler ve en fazla 200.000 UTF-16 kod birimi kabul eder. Önce kısa, zararsız örnek kullan; ardından üretilen değeri tam olarak inceleyip onu okuyacak sistemde dene. Sadece metnin değişmiş görünmesi, hedef sistemin beklediği biçime ulaştığını kanıtlamaz.

URL kodlama ile HTML kaçış işlemi farklı sorunları çözer. Adresi HTML içine yerleştiriyorsan çevresindeki işaretlemenin de kendine ait kaçış kuralları vardır. Paylaştığın örneklerde gizli belirteçleri ve kişisel bilgileri kullanma. Yüzde işaretleri içeren adres, çözen herkes tarafından okunabilir; kodlanmış olması onu özel veya gizli yapmaz.