Skip to content

Latest commit

 

History

History
119 lines (69 loc) · 6.21 KB

uri.ru.md

File metadata and controls

119 lines (69 loc) · 6.21 KB
Raw

uri

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

Обзор

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

Имя Тип возвращаемого значения Описание
decodeURI(str {String}) String Служит для декодирования URI.
decodeURIComponent(str {String}) String Служит для декодирования URI компонента.

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

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

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

Элемент Имя Возвращаемое значение Описание
querystring parse(str {String}) Object Формирует объект на основании параметров запроса адресной строки.
stringify(obj {Object}) String Формирует строку запроса на основании свойств объекта.

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

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

  • 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. Имена свойств в строке отделяются от значений символом =, пары разделяются символом &.