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

CKTIS / JavaScript

encodeURI() — kódovanie celého URI

encodeURI() kóduje znaky celého URI a niektoré oddeľovače ponecháva nezmenené. Vráti nový reťazec s percentuálnym kódovaním UTF-8; nie je určená na kódovanie jednotlivých hodnôt parametrov.

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

encodeURI(uri)

encodeURI(uri) je globálna funkcia ECMAScriptu, nie rozhranie prehliadača. Prevedie argument na reťazec a vráti nový reťazec, v ktorom vybrané znaky nahradí sekvenciami %HH predstavujúcimi bajty UTF-8. Medzera sa zmení na %20, nie na +.

Písmená ASCII, číslice a znaky -_.!~*'();/?:@&=+$,# ponechá nezmenené. Znaky &, = a # si tak zachovávajú osobitný význam, funkcia však nezachováva štruktúru každého platného URI. Napríklad hranaté zátvorky okolo literálu adresy IPv6 percentuálne zakóduje: z http://[::1]/ vznikne http://%5B::1%5D/, teda adresa URL s neplatným hostiteľom. Pre jednotlivú hodnotu parametra použite encodeURIComponent(), ktorá kóduje aj znaky &, = a #.

Ak pomocou encodeURIComponent() kódujete jeden segment cesty, hodnoty tvorené presne . alebo .. pred kódovaním odmietnite. Funkcia ich ponechá nezmenené, takže ich analyzátor URL môže pri normalizácii cesty vyhodnotiť ako bodkové segmenty namiesto toho, aby ich zachoval ako doslovné údaje. Segment .. môže odstrániť predchádzajúci segment cesty.

Funkcia neoveruje platnosť ani bezpečnosť adresy. Znak % kóduje ako %25, takže opakované kódovanie mení existujúce escape sekvencie: %20 sa zmení na %2520. Nespárovaná náhradná kódová jednotka UTF-16 spôsobí URIError; platný pár týchto jednotiek sa zakóduje ako jeden kódový bod.

Príklad ukazuje, ktoré oddeľovače zostanú v uvedenej adrese URL nezmenené, ako sa kódujú é a medzery a aký je rozdiel medzi kódovaním celého URI a kódovaním jednej jeho časti.

Príklady

const uri = "https://example.com/café menu?q=tea&size=large#top";
console.log(encodeURI(uri));
console.log(encodeURIComponent("tea&size=large"));
console.log(encodeURI("%20"));

Výsledok

https://example.com/caf%C3%A9%20menu?q=tea&size=large#top
tea%26size%3Dlarge
%2520

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje