uri

Блок предоставляет объект, содержащий набор методов для декодирования строки из формата URI.

Обзор

Свойства и методы объекта

Элементы блока

Свойства и методы объекта

Публичные технологии блока

Блок реализован в технологиях:

• vanilla.js

Свойства и методы объекта

Оба метода являются оберткой над соответствующими стандартными методами JavaScript decodeURI и decodeURIComponent.

В ходе работы методы проверяют соответствие формата переданной строки UTF-8. При несоответствии генерируется ошибка.

Метод decodeURI

Служит для декодирования URI. Метод идентичен стандартному методу JavaScript decodeURI, но поддерживает кириллическую кодировку CP-1251.

Принимаемые аргументы:

• str {String} – строка с последовательностями экранирования. Обязательный аргумент.

Возвращаемое значение: String. В случае если последовательности экранирования в строке не найдены метод возвращают ее без изменений.

Пример:

modules.require('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('uri', function(uri){
    uri.decodeURIComponent("JavaScript_%D1%88%D0%B5%D0%BB%D0%BB%D1%8B");
    // "JavaScript_шеллы"
})

Элементы блока

Элемент querystring

Элемент предоставляет объект, содержащий набор методов для работы со строкой запроса формата URI.

Свойства и методы объекта

Метод parse

Формирует объект на основании строки параметров в формате URI.

Принимаемые аргументы:

• str {String} – строка с параметрами в виде пар ключ-значение. Ключ отделяется от значения символом =. Пары разделяются символом &. В процессе обработки, ключи и значения декодируются из формата URI. Обязательный аргумент.

Возвращаемое значение: Object. Объект, сформированный на основании параметров адресной строки.

Метод stringify

Формирует строку запроса в формате URI на основании объекта.

Принимаемые аргументы:

• obj {Object} – объект, на основании которого формируется строка. Обязательный аргумент.

Возвращаемое значение: String. Имена свойств в строке отделяются от значений символом =, пары разделяются символом &.