Справочник JavaScript

encodeURIComponent

Кодирует текст для безопасной вставки в часть URL.

Доступно с: ES3

Синтаксис

encodeURIComponent(str)

Параметры

Параметр	Тип	Описание
str	string	Текст, который нужно вставить в URL.

Возвращаемое значение

stringСтрока, в которой специальные символы заменены кодами вида %20.

Примеры

Пробелы, амперсанды и не-латинские символы:

console.log(encodeURIComponent('rock & roll'));
console.log(encodeURIComponent('café'));

Результат:

rock%20%26%20roll
caf%C3%A9

Параметр поиска в адресе:

const query = 'tea & cake';
const url = `https://example.com/search?q=${encodeURIComponent(query)}`;
 
console.log(url);

Результат:

https://example.com/search?q=tea%20%26%20cake

Примечания

Без кодирования символ & в значении разорвал бы параметр на два. Для целых адресов есть encodeURI(): он не трогает /, ? и &. Удобнее всего собирать параметры через URLSearchParams — он кодирует сам.

См. также

decodeURIComponent — Раскодирует текст, закодированный для URL.
URLSearchParams — Читает и собирает параметры адреса (часть после ?).
URL — Разбирает адрес на части и собирает его обратно.

Вопросы и ответы по теме

В учебнике

Запросы к серверу: fetch — Функция fetch в JavaScript: GET- и POST-запросы, объект ответа, статус, response.ok, разбор JSON и обработка ошибок.

Спасибо, что читаете!