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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.