Kaçmanın yanlış anlaşılması kolaydır çünkü birçok farklı iş uzaktan benzer görünür. Elinizde bir metin var, metin özel karakterler içeriyor ve onu yanlış anlamadan başka bir sistemin alması gerekiyor. Hata, bir tür kaçışın her yerde işe yaradığını varsaymaktır.
URL kodlama, HTML kaçışı ve JSON kaçışı farklı sorunları çözer. Sorgu dizesindeki boşluk, oluşturulan HTML'deki < karakteriyle veya JSON dizesindeki tırnak işaretiyle aynı sorun değildir. Case / Slug / Escape aracı, bu çıktıları birbirine yakın tutarak yardımcı olur, ancak yararlı kısım, hangi çıktının hazırladığınız hedefe ait olduğunu bilmektir.
URL kodlaması, URL'ler ve sorgu değerleri içindir
Metin bir URL bileşenine, özellikle de bir sorgu parametresine veya boşluk, noktalama işareti veya yol açısından güvenli olmayan karakterler içerebilen bir değere girerken URL kodlamasını kullanın.
Bir destek bağlantısının pricing & billing gibi bir arama terimi içermesi gerektiğini varsayalım. Bu ifadeyi doğrudan bir URL'ye yapıştırmak, URL'nin yorumlanma biçimini değiştirebilir, çünkü & zaten bir sorgu dizesi içinde anlam taşır. URL kodlaması, metni, URL sözdizimiyle karıştırılmadan URL içinde dolaşabilecek bir forma dönüştürür.
Bu, bir slug oluşturmaktan farklıdır. Bir slug genellikle bir başlığı pricing-and-billing gibi okunabilir bir yol bölümüne dönüştürür. URL kodlaması, aktarım için orijinal değeri daha doğrudan korur.
HTML kaçışı, HTML'de işlenecek metin içindir
Metnin bir HTML bağlamı içinde metin olarak görünmesi, biçimlendirme haline gelmesi değil, görünmesi gerektiğinde HTML çıkışını kullanın.
Bir kod örneği <button> içeriyorsa ve okuyucuların bu karakterleri görmesini istiyorsanız, tarayıcının karakterlerin çıkışlı olması gerekir. Aksi takdirde bunları gerçek bir unsur olarak yorumlayabilir. HTML kaçışı, içeriğin görünür metin olarak kalması gereken yerlerde metnin HTML sözdizimi olarak okunmasını engellemekle ilgilidir.
Bu, belgelerde, CMS alanlarında, değişiklik günlüklerinde ve ürün kopyasında önemlidir. Kaynak metnin, sayfa yapısının bir parçası olmaması gereken işaretleme, snippet veya kullanıcı tarafından oluşturulan değer örneklerini içermesi özellikle önemlidir.
JSON kaçışı, JSON içindeki dize değerleri içindir
Metnin bir JSON dizesinin içine güvenli bir şekilde yerleştirilmesi gerektiğinde JSON kaçışını kullanın.
Normal düzyazıda tırnak işareti zararsızdır ancak bir JSON dizesinin içinde dizeyi erken kapatabilir. Yeni satırın JSON'u geçerli tutacak bir temsile de ihtiyacı olabilir. JSON'dan kaçış, çevreleyen JSON'u ayrıştırılabilir tutarken değeri korumakla ilgilidir.
Bu genellikle ekipler API örneklerini, yapılandırma parçacıklarını, analiz verilerini veya örnek verileri paylaştığında ortaya çıkar. Bir sonraki adım daha kapsamlı yapılandırılmış veri temizliğiyse, bu makaleyi Bir API Örneği Paylaşmadan Önce JSON Nasıl Formatlanır ve JSON / YAML / TOML Dönüştürücüsü ile eşleştirin.
Hedefe göre kaçışı seçin
En basit kural önce varış noktasıdır.
| Varış noktası | Kullanmak | Neden |
|---|---|---|
| URL sorgu değeri veya URL bileşeni | URL kodlaması | Metnin URL sözdizimi olarak yorumlanmasını önler |
| HTML içindeki görünür metin | HTML kaçışı | Özel karakterlerin işaretleme olmasını engeller |
| JSON içindeki dize değeri | JSON kaçıyor | Tırnak işaretlerini, eğik çizgileri ve satır sonlarını ayrıştırılabilir tutar |
| Herkese açık makale veya rota başlığı | Slug nesil | Her karakteri korumak yerine okunabilir yol metni oluşturur |
Converty yardımcı olur çünkü her durum için ayrı bir kodlayıcı açmadan bir kez yapıştırabilir ve çıktıları karşılaştırabilirsiniz. Bu işi orantılı tutar. Bir boru hattı inşa etmiyorsunuz; gitmesi gereken yer için bir metin değeri hazırlıyorsunuz.
Bir sonraki çıktının bir slug, URL kodlu bir değer, HTML açısından güvenli bir metin veya JSON açısından güvenli bir dize olması gerekip gerekmediğine karar vermeniz gerektiğinde Case / Slug / Escape aracını açın.
