Бекство је лако погрешити јер неколико различитих послова изгледа слично из даљине. Имате текст, текст садржи специјалне знакове, а други систем треба да га прими без да га погрешно разуме. Грешка је претпоставка да једна врста бекства функционише свуда.
Кодирање УРЛ-а, избегавање ХТМЛ-а и избегавање ЈСОН-а решавају различите проблеме. Размак у стрингу упита није исти проблем као знак < у приказаном ХТМЛ-у или наводник унутар ЈСОН стринга. Алат Цасе / Slug / Есцапе помаже тако што држи те излазе близу један другом, али користан део је знати који излаз припада одредишту које припремате.
УРЛ кодирање је за УРЛ адресе и вредности упита
Користите УРЛ кодирање када текст улази у УРЛ компоненту, посебно параметар упита или вредност која може да садржи размаке, знакове интерпункције или знакове који нису безбедни за путању.
Претпоставимо да веза за подршку треба да садржи термин за претрагу као што је pricing & billing. Налепљивање те фразе директно у УРЛ може да промени начин на који се УРЛ тумачи јер & већ има значење унутар стринга упита. Кодирање УРЛ-а претвара текст у форму која може да путује унутар УРЛ-а без забуне са синтаксом УРЛ-а.
Ово се разликује од прављења slug. slug обично претвара наслов у читљив сегмент путање као што је pricing-and-billing. УРЛ кодирање чува оригиналну вредност директније за транспорт.
ХТМЛ есцапеинг је за текст који ће бити приказан у ХТМЛ-у
Користите ХТМЛ избегавање када текст треба да се појави као текст унутар ХТМЛ контекста, а не да постане ознака.
Ако пример кода укључује <button> и желите да читаоци виде те знакове, прегледачу су потребни знакови који се не приказују. Иначе их може протумачити као стварни елемент. ХТМЛ избегавање је спречавање читања текста као ХТМЛ синтаксе на местима где садржај треба да остане видљив текст.
То је важно у документацији, ЦМС пољима, евиденцији промена и копији производа. Посебно је релевантно када изворни текст укључује примере ознака, исечака или вредности које генерише корисник који не би требало да постану део структуре странице.
ЈСОН есцапеинг је за вредности стрингова унутар ЈСОН-а
Користите ЈСОН избегавање када текст треба безбедно да се налази унутар ЈСОН стринга.
Наводник је безопасан у нормалној прози, али унутар ЈСОН стринга може рано затворити стринг. Новом реду такође може бити потребна репрезентација која одржава ЈСОН валидним. Избегавање ЈСОН-а се односи на очување вредности док се околни ЈСОН може рашчланити.
Ово се често појављује када тимови деле АПИ примере, исечке конфигурације, корисне податке за аналитику или узорке података. Ако је следећи корак шире чишћење структурираних података, упарите овај чланак са Како форматирати ЈСОН пре дељења примера АПИ-ја и ЈСОН/ИАМЛ/ТОМЛ Цонвертер.
Изаберите излаз на основу одредишта
Најједноставније правило је прво одредиште.
| Одредиште | Користите | Зашто |
|---|---|---|
| Вредност УРЛ упита или УРЛ компонента | УРЛ кодирање | Спречава тумачење текста као УРЛ синтаксе |
| Видљиви текст унутар ХТМЛ-а | ХТМЛ есцапеинг | Спречава посебне знакове да постану ознаке |
| Вредност стринга унутар ЈСОН-а | ЈСОН есцапеинг | Омогућава рашчлањивање наводника, косе црте и прелома редова |
| Јавни чланак или наслов руте | Slug генерација | Креира читљив текст путање уместо да чува сваки знак |
Конвертовање помаже јер можете једном да налепите и упоредите излазе без отварања посебног енкодера за сваки случај. То одржава посао пропорционалним. Не градите цевовод; припремате једну текстуалну вредност за место на које треба да иде.
Отворите алатку Цасе / Slug / Есцапе када треба да одлучите да ли следећи излаз треба да буде slug, УРЛ кодирана вредност, ХТМЛ безбедан текст или ЈСОН сигуран стринг.
