URL kodér / dekodér

URL kodér převádí znaky, které nelze přímo použít v URL adrese, na procentově zakódované sekvence. URL dekodér tento proces obrátí a převede procentově zakódovaný text zpět na původní znaky. Tato stránka to zvládá oběma směry, pro jednotlivou komponentu URL i celou URL adresu.

Nástroj využívá čtyři standardní funkce JavaScriptu:

• encodeURIComponent — pro kódování jedné komponenty URL, například hodnoty parametru dotazu.
• encodeURI — pro kódování celé URL adresy při zachování vyhrazených znaků jako : / ? # & = jež mají strukturální význam.
• decodeURIComponent — pro dekódování jedné komponenty URL zpět na původní znaky.
• decodeURI — pro dekódování celé URL adresy bez dotýkání se vyhrazených znaků.

Všechny převody jsou kompatibilní s UTF-8, takže písmena s diakritikou, emoji a znaky z nematinských písem jsou zpracovávány správně. Nic se nenahrává, nic se neukládá a neprovádějí se žádná volání API.

Několik praktických příkladů, jak kódování URL vypadá v praxi:

• Mezera se změní na %20, takže ahoj světe se zakóduje jako ahoj%20sv%C4%9Bte.
• Lomítko v hodnotě dotazu se změní na %2F, takže a/b se jako parametr změní na a%2Fb.
• Otazník v hodnotě se změní na %3F, takže co? se změní na co%3F.
• Ampersand v hodnotě se změní na %26, čímž se zabrání narušení okolního řetězce dotazu.
• Mřížka v hodnotě se změní na %23, takže c# se změní na c%23.
• Znaky mimo ASCII používají vícebajtové sekvence UTF-8. Například café se změní na caf%C3%A9 (é jsou dva bajty UTF-8).
• Emoji také používají vícebajtové UTF-8: 😀 se změní na %F0%9F%98%80.

Přepněte nástroj do režimu Dekódovat a vložte libovolný z těchto zakódovaných řetězců, abyste viděli přesně obnovený původní text.

Výběr správného režimu je důležitý, protože oba kodéry zacházejí s vyhrazenými znaky odlišně.

Použijte režim Komponenta (encodeURIComponent / decodeURIComponent), když kódujete jednu hodnotu, která bude vložena do URL adresy — například hodnotu parametru dotazu, segment cesty nebo hodnotu fragmentu. Režim Komponenta procentově zakóduje vyhrazené znaky (: / ? # [ ] @ ! $ & ' ( ) * + , ; =), aby nemohly náhodně změnit strukturu okolní URL adresy.

Použijte režim Celá URL (encodeURI / decodeURI), pokud máte celou URL adresu jako https://priklad.cz/cesta?dotaz=hodnota#fragment a chcete pouze zakódovat nezabezpečené znaky (například mezery nebo znaky mimo ASCII), aniž byste se dotkli vyhrazených strukturních znaků.

Častou chybou je použití encodeURI na hodnotu, která má být parametrem dotazu. Vyhrazené znaky pak zůstanou nedotčeny, což může poškodit okolní URL adresu. V případě pochybností zakódujte každou hodnotu dotazu pomocí encodeURIComponent a poté sestavte URL adresu.

Procentové kódování (nazývané také kódování URL) je způsob, jak v URL adrese reprezentovat znaky, které jsou buď vyhrazeny (mají strukturální význam), nebo v URL adresách vůbec nejsou povoleny. Každý nezabezpečený bajt se zapíše jako znak procenta následovaný dvěma hexadecimálními číslicemi — například %20 pro mezeru, %2F pro lomítko nebo %3F pro otazník.

Kódování pracuje s bajty, nikoli přímo se znaky. Moderní URL adresy používají UTF-8 pro převod znaků na bajty, a proto může jedno písmeno s diakritikou odpovídat dvěma procentově zakódovaným bajtům a emoji čtyřem. Tento nástroj vždy používá UTF-8, takže zakódované řetězce jsou interoperabilní se zbytkem webu.

Procentové kódování je definováno v RFC 3986. Nativní funkce JavaScriptu zde použité tuto specifikaci implementují, takže hodnota zakódovaná pomocí encodeURIComponent v libovolném moderním prohlížeči bude správně dekódována pomocí decodeURIComponent kdekoliv jinde.

Tento URL kodér dekodér se hodí vždy, když potřebujete bezpečně přesunout text do nebo z URL adresy. Typické scénáře:

• Kódování textu pro řetězec dotazu před vložením do požadavku API, řádku protokolu nebo adresního řádku prohlížeče.
• Dekódování parametrů URL z protokolu požadavků nebo exportu analytiky pro čtení původních hodnot.
• Kontrola dlouhé zakódované URL adresy jejím dekódováním a ověřením, co je skutečně předáváno.
• Zakódování speciálních znaků v URL adrese před jejím sdílením v chatu, dokumentaci nebo JSON payloadu.
• Výuka nebo studium mapování procentového kódování a sekvencí bajtů UTF-8 na znaky.

Protože nástroj běží zcela ve vašem prohlížeči, je vhodný i pro citlivé URL adresy (interní odkazy, tokeny, podepsané URL), které raději nevkládáte do vzdálené služby.

Kódování URL a čistění URL jsou dvě různé operace, které jsou často zaměňovány.

Kódování URL (tento nástroj) transformuje znaky do procentového kódování a naopak. Struktura URL adresy je zachována; nic se nepřidává ani neodstraňuje.

Čistění URL (samostatný typ nástroje) odstraňuje sledovací parametry jako utm_source, utm_medium, fbclid, gclid a podobné klíče dotazu z URL adresy, takže výsledný odkaz již neobsahuje metadata sledování. Čistění URL mění parametry v URL adrese — kódování ne.

Pokud chcete odebrat sledovací parametry, potřebujete specializovaný nástroj pro čistění URL. Pokud chcete kódovat nebo dekódovat text do/z procentového kódování, je to správný nástroj.