CKTIS / JavaScript
encodeURI() — кодиране на цял URI
encodeURI() кодира знаците в цял URI, като оставя някои разделители непроменени. Връща нов низ с 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
Синтаксис
encodeURI(uri)encodeURI(uri) е глобална функция на ECMAScript, а не API на браузъра. Тя преобразува аргумента си в низ и връща нов низ, като заменя избрани знаци с последователности %HH, представящи UTF-8 байтове. Интервалът става %20, а не +.
ASCII буквите, цифрите и знаците -_.!~*'();/?:@&=+$,# остават непроменени. Знаците &, = и # запазват специалното си значение, но функцията не запазва структурата на всеки валиден URI. Например тя прилага процентно кодиране към квадратните скоби около литерал на IPv6 адрес: http://[::1]/ става http://%5B::1%5D/, тоест URL с невалиден хост. За отделна стойност на параметър използвайте encodeURIComponent(), която кодира и знаците &, = и #.
Ако използвате encodeURIComponent() за кодиране на единичен сегмент от пътя, отхвърлете стойностите, които са точно . или .., преди кодирането. Функцията ги оставя непроменени и при нормализиране на пътя анализаторът на URL може да ги третира като сегменти с точки, вместо да ги запази като буквални данни. Сегментът .. може да премахне предходния сегмент от пътя.
Функцията не проверява дали даден адрес е валиден или безопасен. Тя кодира % като %25, затова повторното кодиране променя съществуващите escape последователности: %20 става %2520. Несдвоена UTF-16 сурогатна единица причинява URIError; валидна сурогатна двойка се кодира като една кодова точка.
Примерът показва кои разделители остават непроменени в дадения URL, как се кодират é и интервалите и каква е разликата между кодиране на цял URI и кодиране на негова отделна съставна част.
Примери
const uri = "https://example.com/café menu?q=tea&size=large#top";
console.log(encodeURI(uri));
console.log(encodeURIComponent("tea&size=large"));
console.log(encodeURI("%20"));Резултат
https://example.com/caf%C3%A9%20menu?q=tea&size=large#top tea%26size%3Dlarge %2520
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.