База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

decodeURI — декодиране на URI

decodeURI декодира процентните escape последователности в текст на URI, като запазва кодираните разделители като %2F. Научете как се различава от decodeURIComponent и как обработва неправилно подадени данни.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

decodeURI(encodedURI)

decodeURI(encodedURI) е глобална функция на ECMAScript, предназначена за декодиране на цели URI адреси. Първо преобразува аргумента си в низ, след което връща нов низ: последователностите %HH, представящи UTF-8 байтове, стават съответните Unicode знаци. Функцията не променя входа и не изисква API на браузъра.

Тя запазва процентните escape последователности, представящи ;/?:@&=+$,#, включително главните и малките букви в шестнадесетичните цифри. Затова %20 става интервал, но %2F остава %2F. И буквалният + остава непроменен: функцията не декодира формулярната конвенция, при която интервалите се представят с +.

decodeURIComponent е предназначена за отделни компоненти на URI и декодира и кодираните разделители, например %2F до /. Не я прилагайте безразборно върху цял URI, защото така може да промените границите между компонентите му. decodeURI не е парсер или валидатор на целия адрес.

Неправилна процентна escape последователност, например %ZZ, или непълно или невалидно UTF-8 кодиране предизвиква URIError, вместо да върне частичен резултат. При външни данни обработвайте този случай с try...catch. Декодирайте само необходимия слой на кодиране: следващо извикване може отново да промени резултата; например %2520 първо става %20, а след това интервал.

Примери

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);
}

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници