Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje