CKTIS / JavaScript
encodeURIComponent — kódovanie komponentu URI
encodeURIComponent kóduje jednu komponentu URI, napríklad hodnotu parametra dopytu. Špeciálne znaky a znaky mimo ASCII prevádza na percentuálne sekvencie predstavujúce bajty UTF-8.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
encodeURIComponent(uriComponent)encodeURIComponent(uriComponent) je globálna funkcia ECMAScriptu, nie rozhranie dostupné iba v prehliadači. Prevedie argument na reťazec a vráti zakódovaný reťazec. Použite ju pre jednu hodnotu, nie pre celú adresu.
Bez zmeny ponecháva písmená A–Z, a–z, číslice 0–9 a znaky - _ . ! ~ * ' ( ). Ostatné znaky prevedie na bajty UTF-8 zapísané ako %HH. Medzera sa zmení na %20, nie na +; doslovné + sa zmení na %2B.
Na rozdiel od encodeURI kóduje aj oddeľovače, napríklad &, =, /, ? a #. Po zakódovaní tieto znaky pri skladaní URI neslúžia ako oddeľovače. Apostrofy a zátvorky však zostávajú nezmenené a v niektorých syntaxiach URI môžu naďalej slúžiť ako oddeľovače, napríklad v adresách URL protokolu OData. Nejde však o HTML escapovanie ani o overenie adresy. Pri opätovnom zakódovaní výsledku sa % zmení na %25.
decodeURIComponent obráti kódovanie platných údajov. Nespárovaný UTF-16 surrogate v argumente funkcie encodeURIComponent spôsobí chybu URIError; funkcia ho automaticky nenahradí. Príklad ukazuje kódovanie znaku Unicode, medzery a oddeľovačov a následnú kontrolu, či sa dá kódovanie obrátiť.
Príklady
const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);Výsledok
%C5%BC%20%26%2B%2F true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.