Príprava jednej hodnoty pre URL
Nástroj použite na hodnotu parametra dopytu, segment cesty alebo inú hodnotu, ktorú vložíte do URL. Fráza s medzerou dostane na jej mieste %20; ampersand v hodnote sa zmení na %26 namiesto začiatku ďalšieho parametra. Znak mimo ASCII sa najprv zakóduje ako UTF-8 a potom sa zobrazí jednou alebo viacerými percentovými trojicami. Hodnota tak zostane oddelená od interpunkcie, ktorá spája časti adresy.
Okolitú URL zostavte osobitne. Ak sem vložíte celú adresu, jej dvojbodky, lomky, otázniky a rovnítka sa môžu zakódovať a výsledok už nebude tá istá použiteľná adresa. Pri URL vyhľadávania pripravte základ adresy a názov parametra, hodnotu zakódujte raz a vložte ju na správne miesto. Mnohé knižnice ponúkajú URLSearchParams alebo podobné konštruktory. Už zakódovanú hodnotu nekódujte znova, pokiaľ cieľový systém výslovne nevyžaduje ďalšiu vrstvu.
Percentové kódovanie časti URL
URL sa skladá zo štruktúrnych oddeľovačov a hodnôt. Lomka oddeľuje časti cesty, otáznik začína dopyt a ampersand oddeľuje parametre. Ak hodnota obsahuje medzeru, ampersand alebo znak mimo ASCII, percentové kódovanie zabráni zámene hodnoty so štruktúrou URL. Text sa najprv prevedie na bajty UTF-8; bajty vyžadujúce ošetrenie sa zapíšu ako znak percenta a dve hexadecimálne číslice. Medzera sa často zmení na %20, písmeno s diakritikou zvyčajne vyžaduje viac kódovaných bajtov.
Tento nástroj spracúva jednu časť, napríklad hodnotu parametra alebo segment cesty, nie celú poskladanú URL. Pri zakódovaní celej adresy sa môžu zmeniť aj potrebné oddeľovače. Webové formuláre používajú aj konvenciu application/x-www-form-urlencoded, kde znak plus často znamená medzeru. Tá sa od tu použitého kódovania komponentu líši. Dekódujte zodpovedajúcimi pravidlami, zachovajte štruktúru URL a na skladanie hodnôt podľa možnosti použite rozhranie URL.
Ako používať prevodník
Začnite pôvodným textom a overte, že cieľová aplikácia skutočne vyžaduje zakódovaný zápis. Vložte text alebo načítajte príklad a pred kopírovaním si prezrite výstup. Prevod beží v tomto prehliadači; text sa neposiela na server na konverziu. Tento smer mení zápis informácie, nie význam vety. Pri hľadaní chyby ponechajte zdroj vedľa výsledku a nekódujte dvakrát, pokiaľ cieľový formát výslovne nežiada dve vrstvy.
Ak potrebujete výsledok spätne skontrolovať, ponechajte si pôvodný vstup. Zakódovaný zápis môže vyzerať celkom inak ako text, najmä pri diakritike, emoji, interpunkcii alebo nových riadkoch. Pred použitím výsledku v inom programe zistite, aké kódovanie znakov a presný formát očakáva. Najprv skúste krátky známy príklad a porovnajte výstup v cieľovej aplikácii: podobne vyzerajúce formáty nemusia byť zameniteľné.