Бегството е лесно да се погреши бидејќи неколку различни работни места изгледаат слично од далечина. Имате текст, текстот содржи специјални знаци и друг систем треба да го прими без погрешно да го разбере. Грешката е да се претпостави дека еден вид бегство функционира насекаде.
Кодирањето на URL-то, бегството на HTML и бегството од JSON решаваат различни проблеми. Просторот во низата за барање не е ист проблем како знакот < во изречениот HTML или наводникот во низата JSON. Алатката Case / Slug / Escape помага со тоа што тие излези се блиску еден до друг, но корисниот дел е да знаете кој излез припаѓа на дестинацијата што ја подготвувате.
УРЛ-кодирањето е за URL-адреси и вредности за барање
Користете го кодирањето на URL-то кога текстот влегува во компонента на URL-то, особено параметар за барање или вредност што може да содржи празни места, интерпункциски знаци или знаци кои не се безбедни за патеката.
Да претпоставиме дека врската за поддршка треба да содржи термин за пребарување како што е pricing & billing. Вметнувањето на таа фраза директно во URL може да го промени начинот на интерпретација на URL-то бидејќи & веќе има значење во низата за барање. УРЛ-кодирањето го претвора текстот во форма што може да патува во URL-то без да се меша со синтаксата на URL-то.
Ова е различно од создавање на slug. А slug обично го претвора насловот во читлив сегмент од патеката како што е pricing-and-billing. УРЛ-кодирањето ја зачувува оригиналната вредност подиректно за транспорт.
Избегнувањето на HTML е за текст што ќе биде прикажан во HTML
Користете HTML бегство кога текстот треба да се појави како текст во контекст на HTML, а не да стане ознака.
Ако примерот на кодот вклучува <button> и сакате читателите да ги видат тие знаци, на прелистувачот му треба бегство на знаците. Во спротивно може да ги толкува како актуелен елемент. Избегнувањето на HTML е за спречување текстот да се чита како HTML синтакса на места каде што содржината треба да остане видлив текст.
Тоа е важно во документацијата, полињата CMS, дневниците за промени и копијата на производот. Особено е релевантно кога изворниот текст вклучува примери на обележување, фрагменти или вредности генерирани од корисникот кои не треба да станат дел од структурата на страницата.
Избегањето на JSON е за вредностите на низата во JSON
Користете JSON бегство кога текстот треба безбедно да седи во низа JSON.
Наводникот е безопасен во нормална проза, но во стрингот JSON може рано да ја затвори низата. На нова линија може да и треба и претставување што го одржува валиден JSON. Избегнувањето на JSON е за зачувување на вредноста додека го одржува околниот JSON може да се анализира.
Ова често се појавува кога тимовите споделуваат примери на API, фрагменти од конфигурација, носивост на аналитика или примероци на податоци. Ако следниот чекор е пошироко чистење на структурирани податоци, спојте ја оваа статија со Како да го форматирате JSON пред да споделите пример за API и JSON / YAML / TOML конвертер.
Изберете бегство врз основа на дестинацијата
Наједноставното правило е прво дестинација.
| Дестинација | Користете | Зошто |
|---|---|---|
| Вредност на барањето на URL-адреса или компонента за URL-адреса | УРЛ-кодирање | Не дозволува текстот да се толкува како синтакса на URL-то |
| Видлив текст во HTML | HTML бега | Ги спречува специјалните знаци да станат ознаки |
| Вредност на стрингот во JSON | JSON бега | Одржува наводници, коси црти и прекини на линии кои можат да се анализираат |
| Јавна статија или наслов на маршрутата | Slug генерација | Создава читлив текст на патеката наместо да го зачувува секој знак |
Конвертирањето помага затоа што можете да залепите еднаш и да ги споредите излезите без да отворите посебен енкодер за секој случај. Тоа ја одржува работата пропорционална. Вие не градите гасовод; подготвувате една текстуална вредност за местото каде што треба да оди.
Отворете ја алатката Case / Slug / Escape кога треба да одлучите дали следниот излез треба да биде slug, вредност кодирана со URL, текст безбеден за HTML или низа безбедна за JSON.
