URL Encode ve Decode

Bir URL yalnızca sınırlı bir ASCII karakter kümesi içerebilir. URI sözdizimi için 2005 tarihli RFC 3986 belirtimi bu karakterleri iki gruba ayırır. Ayrılmamış (unreserved) karakterler, yani A–Z, a–z, 0–9 ve - . _ ~ işaretleri, hiçbir zaman kodlanmak zorunda değildir. Ayrılmış (reserved) karakterlerin ise görevleri vardır: : / ? # [ ] @ genel ayırıcıları şemayı, ana bilgisayarı, yolu, sorguyu ve parçayı birbirinden ayırır; ! $ & ' ( ) * + , ; = alt ayırıcıları ise bunların içindeki öğeleri ayırır, sorgu dizesindeki & ve = gibi. Geri kalan her karakter ve düz veri olarak kullanılan her ayrılmış karakter yüzde kodlamasıyla (percent-encoding) kodlanmalıdır.

Yüzde kodlaması, bir baytı % ve ardından gelen iki onaltılık basamak olarak yazar. Metin önce UTF-8'e dönüştürülür; böylece boşluk %20, é (iki bayt) %C3%A9 olur ve bir emoji dört adet %XX grubuna dönüşür. "café & bar" aramasının bağlantıda caf%C3%A9%20%26%20bar olarak görünmesinin nedeni budur: & kodlanır, böylece sunucu onu yeni bir parametrenin başlangıcı sanmaz.

encodeURIComponent, sorgu değeri, yol bölümü veya parametre olarak geçirilen bir yönlendirme URL'si gibi tek bir parça için doğru seçimdir. Ayrılmamış karakterler ile tarihsel nedenlerle JavaScript'in dokunmadığı ! ' ( ) * dışındaki her şeyi kaçırır. encodeURI (tam URL) girdisinin zaten eksiksiz bir adres olduğunu varsayar ve ayrılmış karakterleri olduğu gibi bırakır; bu yüzden https://example.com/a b?q=1 içinde yalnızca boşluk kodlanır. Bir parametre değerinde encodeURI kullanmak klasik bir hatadır: değerin içindeki & veya # korunur ve URL'yi bozar.

Kodu çöz her iki işlevi de tersine çevirir. GET ile gönderilen HTML formları daha eski application/x-www-form-urlencoded biçimini kullanır; bu biçimde boşluk %20 yerine + olarak yazılır. Bunlar için + işaretini boşluk say seçeneğini işaretli tutun; telefon numarasında olduğu gibi gerçek bir artı işareti önemliyse işareti kaldırın. Girdide ardından iki onaltılık basamak gelmeyen bir % varsa ya da geçerli UTF-8 olmayan baytlar bulunuyorsa, kod çözme tahmin yürütmek yerine açık bir mesajla başarısız olur. Metin bir sorgu dizesi içeriyorsa parametreleri aracın altındaki bir tabloda çözülmüş olarak görünür. URL'lerdeki ikili veriler için olağan alternatif Base64url'dir.