Evadarea este ușor de greșit, deoarece mai multe locuri de muncă diferite arată similar de la distanță. Ai text, textul conține caractere speciale și un alt sistem trebuie să-l primească fără să-l înțeleagă greșit. Greșeala este să presupunem că un fel de evadare funcționează peste tot.
Codificarea URL, evadarea HTML și evadarea JSON rezolvă diferite probleme. Un spațiu într-un șir de interogare nu este aceeași problemă cu un caracter < din HTML redat sau cu ghilimele din interiorul unui șir JSON. Instrumentul Caz / Slug / Escape ajută prin menținerea acestor ieșiri apropiate, dar partea utilă este să știi care ieșire aparține destinației pe care o pregătiți.
Codificarea URL este pentru adrese URL și valori de interogare
Utilizați codificarea URL atunci când textul intră într-o componentă URL, în special un parametru de interogare sau o valoare care poate conține spații, semne de punctuație sau caractere care nu sunt sigure pentru calea.
Să presupunem că un link de asistență trebuie să includă un termen de căutare, cum ar fi pricing & billing. Lipirea acestei expresii direct într-o adresă URL poate modifica modul în care este interpretată adresa URL, deoarece & are deja semnificație în interiorul unui șir de interogare. Codificarea URL transformă textul într-o formă care poate călători în interiorul URL-ului fără a fi confundat cu sintaxa URL.
Aceasta este diferită de crearea unui slug. Un slug transformă de obicei un titlu într-un segment de cale lizibil, cum ar fi pricing-and-billing. Codificarea URL păstrează valoarea inițială mai direct pentru transport.
Escape HTML este pentru textul care va fi redat în HTML
Utilizați evadarea HTML atunci când textul trebuie să apară ca text într-un context HTML, nu să devină markup.
Dacă un exemplu de cod include <button> și doriți ca cititorii să vadă acele caractere, browserul are nevoie de evadarea caracterelor. În caz contrar, le poate interpreta ca pe un element real. Evadarea HTML se referă la prevenirea citirii textului ca sintaxă HTML în locurile în care conținutul ar trebui să rămână text vizibil.
Acest lucru contează în documentație, câmpuri CMS, jurnalele de modificări și copierea produsului. Este deosebit de relevant atunci când textul sursă include exemple de markup, fragmente sau valori generate de utilizator care nu ar trebui să devină parte din structura paginii.
Escape JSON este pentru valorile șirurilor din interiorul JSON
Utilizați evadarea JSON atunci când textul trebuie să stea în siguranță într-un șir JSON.
Un ghilimele este inofensiv în proza normală, dar în interiorul unui șir JSON poate închide șirul mai devreme. O linie nouă poate avea nevoie, de asemenea, de reprezentare care păstrează JSON-ul valid. Evadarea JSON se referă la păstrarea valorii, păstrând în același timp analizabil JSON din jur.
Acest lucru apare adesea atunci când echipele partajează exemple de API, fragmente de configurare, încărcături utile de analiză sau date mostre. Dacă următorul pas este curățarea mai amplă a datelor structurate, asociați acest articol cu Cum se formatează JSON înainte de a partaja un exemplu de API și Convertorul JSON / YAML / TOML.
Alegeți scăparea în funcție de destinație
Cea mai simplă regulă este destinația mai întâi.
| Destinaţie | Utilizare | De ce |
|---|---|---|
| Valoarea interogării URL sau componenta URL | codificare URL | Împiedică textul să fie interpretat ca sintaxă URL |
| Text vizibil în interiorul HTML | Scăpare HTML | Împiedică caracterele speciale să devină markup |
| Valoare șir în interiorul JSON | JSON scăpa | Păstrează ghilimele, barele oblice și întreruperile de linie analizabile |
| Articolul public sau titlul rutei | Slug generație | Creează un text care poate fi citit mai degrabă decât să păstreze fiecare caracter |
Converty vă ajută, deoarece puteți lipi o dată și compara ieșirile fără a deschide un encoder separat pentru fiecare caz. Asta menține slujba proporțională. Nu construiți o conductă; pregătești o valoare text pentru locul în care trebuie să ajungă.
Deschideți instrumentul Case / Slug / Escape când trebuie să decideți dacă următoarea ieșire ar trebui să fie un slug, o valoare codificată în URL, text sigur pentru HTML sau un șir sigur pentru JSON.
