Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje