EN RU
Форум

Методология

Технологии

Инструментарий

Библиотеки

Учебные материалы

DocumentationJSDocSource

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

Module uri

A set of helpers to work with URI

Object methods:

decodeURI(str):String
description
Decodes URI string
parameters
str
String
decodeURIComponent(str):String
description
Decodes URI component string
parameters
str
String

uri__querystring

A set of helpers to work with query strings

Object methods:

parse(str):Object
description
Parse a query string to an object
parameters
str
String
stringify(obj):String
description
Serialize an object to a query string
parameters
obj
Object