Блок предоставляет объект, содержащий набор методов для работы со строкой запроса формата URI.
| Имя | Возвращаемое значение | Описание |
|---|---|---|
parse({String} str) |
{Object} |
Формирует объект на основании параметров запроса адресной строки. |
stringify({Object} obj) |
{String} |
Формирует строку запроса на основании свойств объекта. |
| Элемент | Способы использования | Описание |
|---|---|---|
| uri | JS |
Элемент предназначен для декодирования строки из формата URI. |
| Элемент | Имя | Возвращаемое значение | Описание |
|---|---|---|---|
| uri | decodeURI({String} str) |
{String} |
Служит для декодирования URI. |
decodeURIComponent({String} str) |
{String} |
Служит для декодирования URI компонента. |
Блок реализован в технологиях:
vanilla.jsparseФормирует объект на основании строки параметров в формате URI.
Принимаемые аргументы:
str {String} – строка с параметрами в виде пар ключ-значение. Ключ отделяется от значения символом =. Пары разделяются символом &. В процессе обработки, ключи и значения декодируются из формата URI. Обязательный аргумент.Возвращаемое значение: {Object}. Объект, сформированный на основании параметров адресной строки.
stringifyФормирует строку запроса в формате URI на основании объекта.
Принимаемые аргументы:
obj {Object} – объект, на основании которого формируется строка. Обязательный аргумент.
Возвращаемое значение: {String}. Имена свойств в строке отделяются от значений символом =, пары разделяются символом &.
uriЭлемент предоставляет объект, содержащий набор методов для декодирования строки из формата URI.
Оба метода являются оберткой над соответствующими стандартными методами JavaScript decodeURI и decodeURIComponent.
В ходе работы методы проверяют соответствие формата переданной строки UTF-8. При несоответствии генерируется ошибка.
decodeURIСлужит для декодирования URI. Метод идентичен стандартному методу JavaScript decodeURI, но поддерживает кириллическую кодировку CP-1251.
Принимаемые аргументы:
str {String} – строка с последовательностями экранирования. Обязательный аргумент.Возвращаемое значение: {String}. В случае если последовательности экранирования в строке не найдены метод возвращают ее без изменений.
modules.require('querystring__uri', function(uri){
uri.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_шеллы"
})
decodeURIComponentСлужит для декодирование компонента URI. Метод идентичен стандартному методу JavaScript decodeURIComponent, но поддерживает кириллическую кодировку CP-1251.
Принимаемые аргументы:
str {String} – строка с последовательностями экранирования. Обязательный аргумент.Возвращаемое значение: {String}. В случае если последовательности экранирования в строке не найдены метод возвращают ее без изменений.
modules.require('querystring__uri', function(uri){
uri.decodeURIComponent("JavaScript_%D1%88%D0%B5%D0%BB%D0%BB%D1%8B");
// "JavaScript_шеллы"
})