CKTIS / JavaScript
encodeURIComponent — kódování komponenty URI
encodeURIComponent kóduje jednu komponentu URI, například hodnotu parametru dotazu. Speciální znaky a znaky mimo ASCII převádí na procentové sekvence představující bajty UTF-8.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
encodeURIComponent(uriComponent)encodeURIComponent(uriComponent) je globální funkce ECMAScriptu, nikoli rozhraní dostupné pouze v prohlížeči. Převede argument na řetězec a vrátí zakódovaný řetězec. Použijte ji pro jednotlivou hodnotu, nikoli pro celou adresu.
Beze změny ponechává písmena A–Z, a–z, číslice 0–9 a znaky - _ . ! ~ * ' ( ). Ostatní znaky převede na bajty UTF-8 zapsané jako %HH. Mezery se mění na %20, nikoli na +; doslovné + se mění na %2B.
Na rozdíl od encodeURI kóduje také oddělovače, například &, =, /, ? a #. Po zakódování tyto znaky při sestavování URI nefungují jako oddělovače. Apostrofy a závorky však zůstávají beze změny a v některých syntaxích URI mohou nadále sloužit jako oddělovače, například v adresách URL protokolu OData. Nejde však o HTML escapování ani o ověření adresy. Při opětovném zakódování výsledku se % změní na %25.
decodeURIComponent obrací kódování platných dat. Nespárovaný UTF-16 surrogate v argumentu funkce encodeURIComponent způsobí chybu URIError; funkce jej automaticky nenahradí. Příklad ukazuje kódování znaku Unicode, mezery a oddělovačů a následnou kontrolu, zda lze kódování obrátit.
Příklady
const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);Výsledek
%C5%BC%20%26%2B%2F true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.