Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

decodeURI — dekodiranje URI-ja

decodeURI dekodira odstotkovne ubežne sekvence v besedilu URI in ohrani pravilno kodirane ločila, kot je %2F. Preberite, kako se razlikuje od decodeURIComponent in kako obravnava nepravilne podatke.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

decodeURI(encodedURI)

decodeURI(encodedURI) je globalna funkcija ECMAScript, namenjena dekodiranju celotnih URI-jev. Najprej pretvori argument v niz, nato pa vrne nov niz: sekvence %HH, ki predstavljajo bajte UTF-8, pretvori v ustrezne znake Unicode. Vhoda ne spremeni in ne potrebuje brskalniških API-jev.

Ohrani odstotkovne ubežne sekvence, ki predstavljajo znake ;/?:@&=+$,#, vključno z velikostjo črk šestnajstiških števk. Zato %20 postane presledek, %2F pa ostane %2F. Tudi dobesedni + ostane nespremenjen: funkcija ne dekodira obrazčne konvencije, ki presledke zapisuje z +.

decodeURIComponent je namenjena posameznim komponentam URI-ja in dekodira tudi kodirana ločila, na primer %2F v /. Ne uporabljajte je nepremišljeno za celoten URI, saj lahko s tem spremenite meje njegovih komponent. decodeURI ni razčlenjevalnik ali validator celotnega naslova.

Nepravilna odstotkovna ubežna sekvenca, kot je %ZZ, ali nepopolno oziroma neveljavno kodiranje UTF-8 sproži URIError, namesto da bi vrnila delni rezultat. Pri zunanjih podatkih ta primer obravnavajte z try...catch. Dekodirajte samo potrebno raven kodiranja: naslednji klic lahko rezultat znova spremeni; %2520 se na primer najprej spremeni v %20, nato pa v presledek.

Primeri

const encoded = '/caf%C3%A9%20menu?q=a%2Fb+c';
console.log(decodeURI(encoded));
console.log(decodeURIComponent(encoded));

try {
  decodeURI('%E0%A4');
} catch (error) {
  console.log(error.name);
}

Rezultat

/café menu?q=a%2Fb+c
/café menu?q=a/b+c
URIError

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri