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

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

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

Източници