decodeURI()

Функция decodeURI() декодирует Uniform Resource Identifier (URI), ранее созданный функцией encodeURI() или аналогичным методом.

Попробуйте

const uri = "https://mozilla.org/?x=шеллы";
const encoded = encodeURI(uri);
console.log(encoded);
// Expected output: "https://mozilla.org/?x=%D1%88%D0%B5%D0%BB%D0%BB%D1%8B"

try {
  console.log(decodeURI(encoded));
  // Expected output: "https://mozilla.org/?x=шеллы"
} catch (e) {
  // Catches a malformed URI
  console.error(e);
}

Синтаксис

decodeURI(encodedURI)

Параметры

encodedURI

Полный, закодированный Uniform Resource Identifier.

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

Новая строка, представляющая незакодированную версию заданного закодированного Uniform Resource Identifier (URI).

Исключения

URIError

Выбрасывается, если encodedURI содержит %, за которым не следуют две шестнадцатеричные цифры, или если escape-последовательность не кодирует допустимый символ UTF-8.

Описание

decodeURI() — это свойство объекта global.

Функция decodeURI() декодирует URI, рассматривая каждую escape-последовательность в форме %XX как одну единицу кода UTF-8 (один байт). В UTF-8 количество ведущих 1-битов в первом байте, которое может быть 0 (для 1-байтовых ASCII символов), 2, 3 или 4, указывает количество байтов в символе. Таким образом, считывая первую escape-последовательность, decodeURI() может определить, сколько еще escape-последовательностей следует потребить. Если decodeURI() не удается найти ожидаемое количество последовательностей, или если escape-последовательности не кодируют допустимый символ UTF-8, выбрасывается URIError.

decodeURI() декодирует все escape-последовательности, но если escape-последовательность кодирует один из следующих символов, escape-последовательность сохраняется в выходной строке (поскольку они являются частью синтаксиса URI):

; / ? : @ & = + $ , #

Примеры

Декодирование URL с кириллицей

decodeURI(
  "https://developer.mozilla.org/ru/docs/JavaScript_%D1%88%D0%B5%D0%BB%D0%BB%D1%8B",
);
// "https://developer.mozilla.org/ru/docs/JavaScript_шеллы"

decodeURI() против. decodeURIComponent()

decodeURI() предполагает, что входные данные являются полным URI, поэтому она не декодирует символы, которые являются частью синтаксиса URI.

decodeURI(
  "https://developer.mozilla.org/docs/JavaScript%3A%20a_scripting_language",
);
// "https://developer.mozilla.org/docs/JavaScript%3A a_scripting_language"

decodeURIComponent(
  "https://developer.mozilla.org/docs/JavaScript%3A%20a_scripting_language",
);
// "https://developer.mozilla.org/docs/JavaScript: a_scripting_language"

Обработка ошибок

try {
  const a = decodeURI("%E0%A4%A");
} catch (e) {
  console.error(e);
}

// URIError: malformed URI sequence

Спецификации

Совместимость с браузерами

См. также

• decodeURIComponent()
• encodeURI()
• encodeURIComponent()