Skip to content

Latest commit

 

History

History
108 lines (67 loc) · 6.24 KB

uri.ru.md

File metadata and controls

108 lines (67 loc) · 6.24 KB
Raw

querystring

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

Обзор

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

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

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

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

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

Элемент Имя Возвращаемое значение Описание
querystring parse({String} str) {Object} Формирует объект на основании параметров запроса адресной строки.
stringify({Object} obj) {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_шеллы"
})

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

Элемент uri

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

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

Метод parse

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

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

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

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

Метод stringify

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

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

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

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