Строка запроса

Этот модуль предоставляет утилиты для работы со строками запроса. Он предоставляет следующие методы:

querystring.escape

Функция кодирования, используемая querystring.stringify, предоставлена для возможности переопределения при необходимости.

querystring.parse(str[, sep][, eq][, options])

Десериализация строки запроса в объект. Допускается переопределение разделителя ('&') и символа присваивания ('=') по умолчанию.

Объект options может содержать свойство maxKeys (по умолчанию равно 1000), которое будет использоваться для ограничения обработанных ключей. Установите его в 0, чтобы удалить ограничение количества ключей.

Объект options может содержать свойство decodeURIComponent (по умолчанию querystring.unescape), которое может использоваться для декодирования строки с кодировкой non-utf8 при необходимости.

Пример:

querystring.parse('foo=bar&baz=qux&baz=quux&corge')
// returns { foo: 'bar', baz: ['qux', 'quux'], corge: '' }

// Suppose gbkDecodeURIComponent function already exists,
// it can decode `gbk` encoding string
querystring.parse('w=%D6%D0%CE%C4&foo=bar', null, null,
  { decodeURIComponent: gbkDecodeURIComponent })
// returns { w: '中文', foo: 'bar' }

querystring.stringify(obj[, sep][, eq][, options])

Сериализация объекта в строку запроса. Допускается переопределение разделителя ('&') и символа присваивания ('=') по умолчанию.

Объект options может содержать свойство encodeURIComponent (по умолчанию querystring.escape), которое может использоваться для кодирования строки с кодировкой non-utf8 при необходимости.

Пример:

querystring.stringify({ foo: 'bar', baz: ['qux', 'quux'], corge: '' })
// returns 'foo=bar&baz=qux&baz=quux&corge='

querystring.stringify({foo: 'bar', baz: 'qux'}, ';', ':')
// returns 'foo:bar;baz:qux'

// Suppose gbkEncodeURIComponent function already exists,
// it can encode string with `gbk` encoding
querystring.stringify({ w: '中文', foo: 'bar' }, null, null,
  { encodeURIComponent: gbkEncodeURIComponent })
// returns 'w=%D6%D0%CE%C4&foo=bar'

querystring.unescape

Функция декодирования, используемая querystring.parse, предоставлена для возможности переопределения при необходимости.

В первую очередь будет использоваться decodeURIComponent, но если это не удастся, то произойдет откат к более безопасному эквиваленту, который не выбросит ошибку при неправильно сформированных URL.