CKTIS / JavaScript
encodeURIComponent — кодиране на URI компонент
encodeURIComponent кодира един URI компонент, например стойността на параметър от заявка. Преобразува специалните и не-ASCII символите в процентни последователности, представящи UTF-8 байтове.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
encodeURIComponent(uriComponent)encodeURIComponent(uriComponent) е глобална функция на ECMAScript, а не API, достъпен само в браузър. Тя преобразува аргумента си в низ и връща кодиран низ. Използвайте я за отделна стойност, а не за цял адрес.
Оставя непроменени буквите A–Z, a–z, цифрите 0–9 и знаците - _ . ! ~ * ' ( ). Другите символи се преобразуват в UTF-8 байтове, изписани като %HH. Интервалът става %20, а не +; буквалният + става %2B.
За разлика от encodeURI, функцията кодира и разделители като &, =, /, ? и #. След кодиране тези знаци не служат като разделители при съставяне на URI. Апострофите и скобите обаче остават непроменени и все още могат да служат като разделители в някои видове URI синтаксис, например в URL адреси на OData. Това обаче не е HTML екраниране или проверка на адрес. При повторно кодиране на резултата % се превръща в %25.
decodeURIComponent обръща кодирането на валидни данни. Неспарен UTF-16 сурогат в аргумента на encodeURIComponent причинява URIError; функцията не го заменя автоматично. Примерът показва кодирането на Unicode символ, интервал и разделители, след което проверява дали кодирането може да се обърне.
Примери
const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);Резултат
%C5%BC%20%26%2B%2F true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.