Příprava jedné hodnoty pro URL
Nástroj použijte pro hodnotu parametru dotazu, segment cesty nebo jinou hodnotu, kterou vložíte do URL. Fráze s mezerou dostane na jejím místě %20; ampersand v hodnotě se změní na %26 místo začátku dalšího parametru. Znak mimo ASCII se nejprve zakóduje jako UTF-8 a pak se zobrazí jednou či více procentovými trojicemi. Hodnota tak zůstane oddělena od interpunkce, která spojuje části adresy.
Okolní URL sestavte zvlášť. Vložíte-li sem celou adresu, její dvojtečky, lomítka, otazníky a rovnítka se mohou zakódovat a výsledek už nebude stejná použitelná adresa. U URL vyhledávání připravte základ adresy a název parametru, hodnotu zakódujte jednou a vložte ji na správné místo. Mnohé knihovny nabízejí URLSearchParams nebo obdobné konstruktory. Již zakódovanou hodnotu nekódujte znovu, pokud cílový systém výslovně nevyžaduje další vrstvu.
Procentové kódování části URL
URL se skládá ze strukturálních oddělovačů a hodnot. Lomítko odděluje části cesty, otazník zahajuje dotaz a ampersand odděluje parametry. Pokud hodnota obsahuje mezeru, ampersand nebo znak mimo ASCII, procentové kódování zabrání záměně hodnoty se strukturou URL. Text se nejdříve převede na bajty UTF-8; bajty vyžadující ošetření se zapisují jako znak procenta a dvě hexadecimální číslice. Mezera se často změní na %20, písmeno s diakritikou obvykle vyžaduje více zakódovaných bajtů.
Tento nástroj zpracovává jednu část, například hodnotu parametru nebo segment cesty, nikoli celou sestavenou URL. Zakódování celé adresy může změnit i potřebné oddělovače. Webové formuláře používají také konvenci application/x-www-form-urlencoded, v níž znak plus často označuje mezeru. Ta se liší od zdejšího kódování komponenty. Dekódujte odpovídajícími pravidly, zachovejte strukturu URL a k sestavení jednotlivě zakódovaných hodnot pokud možno použijte rozhraní URL.
Jak používat převodník
Začněte původním textem a ověřte, že cílová aplikace skutečně vyžaduje zakódovaný zápis. Vložte text nebo načtěte příklad a před kopírováním si prohlédněte výstup. Převod běží v tomto prohlížeči; text se neposílá na server ke konverzi. Tento směr mění zápis informace, nikoli význam věty. Při hledání chyby ponechte zdroj vedle výsledku a nekódujte dvakrát, pokud cílový formát výslovně nežádá dvě vrstvy.
Pokud potřebujete výsledek zpětně ověřit, uchovejte původní vstup. Zakódovaný zápis může vypadat úplně jinak než text, zejména u diakritiky, emoji, interpunkce či nových řádků. Před použitím výsledku v jiném programu zjistěte, jaké kódování znaků a přesný formát očekává. Nejprve zkuste krátký známý příklad a porovnejte výstup v cílové aplikaci: podobně vypadající formáty nemusejí být zaměnitelné.