| 'use strict'; |
| |
| var utils = require('./utils'); |
| var formats = require('./formats'); |
| |
| var arrayPrefixGenerators = { |
| brackets: function brackets(prefix) { // eslint-disable-line func-name-matching |
| return prefix + '[]'; |
| }, |
| indices: function indices(prefix, key) { // eslint-disable-line func-name-matching |
| return prefix + '[' + key + ']'; |
| }, |
| repeat: function repeat(prefix) { // eslint-disable-line func-name-matching |
| return prefix; |
| } |
| }; |
| |
| var toISO = Date.prototype.toISOString; |
| |
| var defaults = { |
| delimiter: '&', |
| encode: true, |
| encoder: utils.encode, |
| encodeValuesOnly: false, |
| serializeDate: function serializeDate(date) { // eslint-disable-line func-name-matching |
| return toISO.call(date); |
| }, |
| skipNulls: false, |
| strictNullHandling: false |
| }; |
| |
| var stringify = function stringify( // eslint-disable-line func-name-matching |
| object, |
| prefix, |
| generateArrayPrefix, |
| strictNullHandling, |
| skipNulls, |
| encoder, |
| filter, |
| sort, |
| allowDots, |
| serializeDate, |
| formatter, |
| encodeValuesOnly |
| ) { |
| var obj = object; |
| if (typeof filter === 'function') { |
| obj = filter(prefix, obj); |
| } else if (obj instanceof Date) { |
| obj = serializeDate(obj); |
| } else if (obj === null) { |
| if (strictNullHandling) { |
| return encoder && !encodeValuesOnly ? encoder(prefix, defaults.encoder) : prefix; |
| } |
| |
| obj = ''; |
| } |
| |
| if (typeof obj === 'string' || typeof obj === 'number' || typeof obj === 'boolean' || utils.isBuffer(obj)) { |
| if (encoder) { |
| var keyValue = encodeValuesOnly ? prefix : encoder(prefix, defaults.encoder); |
| return [formatter(keyValue) + '=' + formatter(encoder(obj, defaults.encoder))]; |
| } |
| return [formatter(prefix) + '=' + formatter(String(obj))]; |
| } |
| |
| var values = []; |
| |
| if (typeof obj === 'undefined') { |
| return values; |
| } |
| |
| var objKeys; |
| if (Array.isArray(filter)) { |
| objKeys = filter; |
| } else { |
| var keys = Object.keys(obj); |
| objKeys = sort ? keys.sort(sort) : keys; |
| } |
| |
| for (var i = 0; i < objKeys.length; ++i) { |
| var key = objKeys[i]; |
| |
| if (skipNulls && obj[key] === null) { |
| continue; |
| } |
| |
| if (Array.isArray(obj)) { |
| values = values.concat(stringify( |
| obj[key], |
| generateArrayPrefix(prefix, key), |
| generateArrayPrefix, |
| strictNullHandling, |
| skipNulls, |
| encoder, |
| filter, |
| sort, |
| allowDots, |
| serializeDate, |
| formatter, |
| encodeValuesOnly |
| )); |
| } else { |
| values = values.concat(stringify( |
| obj[key], |
| prefix + (allowDots ? '.' + key : '[' + key + ']'), |
| generateArrayPrefix, |
| strictNullHandling, |
| skipNulls, |
| encoder, |
| filter, |
| sort, |
| allowDots, |
| serializeDate, |
| formatter, |
| encodeValuesOnly |
| )); |
| } |
| } |
| |
| return values; |
| }; |
| |
| module.exports = function (object, opts) { |
| var obj = object; |
| var options = opts ? utils.assign({}, opts) : {}; |
| |
| if (options.encoder !== null && options.encoder !== undefined && typeof options.encoder !== 'function') { |
| throw new TypeError('Encoder has to be a function.'); |
| } |
| |
| var delimiter = typeof options.delimiter === 'undefined' ? defaults.delimiter : options.delimiter; |
| var strictNullHandling = typeof options.strictNullHandling === 'boolean' ? options.strictNullHandling : defaults.strictNullHandling; |
| var skipNulls = typeof options.skipNulls === 'boolean' ? options.skipNulls : defaults.skipNulls; |
| var encode = typeof options.encode === 'boolean' ? options.encode : defaults.encode; |
| var encoder = typeof options.encoder === 'function' ? options.encoder : defaults.encoder; |
| var sort = typeof options.sort === 'function' ? options.sort : null; |
| var allowDots = typeof options.allowDots === 'undefined' ? false : options.allowDots; |
| var serializeDate = typeof options.serializeDate === 'function' ? options.serializeDate : defaults.serializeDate; |
| var encodeValuesOnly = typeof options.encodeValuesOnly === 'boolean' ? options.encodeValuesOnly : defaults.encodeValuesOnly; |
| if (typeof options.format === 'undefined') { |
| options.format = formats['default']; |
| } else if (!Object.prototype.hasOwnProperty.call(formats.formatters, options.format)) { |
| throw new TypeError('Unknown format option provided.'); |
| } |
| var formatter = formats.formatters[options.format]; |
| var objKeys; |
| var filter; |
| |
| if (typeof options.filter === 'function') { |
| filter = options.filter; |
| obj = filter('', obj); |
| } else if (Array.isArray(options.filter)) { |
| filter = options.filter; |
| objKeys = filter; |
| } |
| |
| var keys = []; |
| |
| if (typeof obj !== 'object' || obj === null) { |
| return ''; |
| } |
| |
| var arrayFormat; |
| if (options.arrayFormat in arrayPrefixGenerators) { |
| arrayFormat = options.arrayFormat; |
| } else if ('indices' in options) { |
| arrayFormat = options.indices ? 'indices' : 'repeat'; |
| } else { |
| arrayFormat = 'indices'; |
| } |
| |
| var generateArrayPrefix = arrayPrefixGenerators[arrayFormat]; |
| |
| if (!objKeys) { |
| objKeys = Object.keys(obj); |
| } |
| |
| if (sort) { |
| objKeys.sort(sort); |
| } |
| |
| for (var i = 0; i < objKeys.length; ++i) { |
| var key = objKeys[i]; |
| |
| if (skipNulls && obj[key] === null) { |
| continue; |
| } |
| |
| keys = keys.concat(stringify( |
| obj[key], |
| key, |
| generateArrayPrefix, |
| strictNullHandling, |
| skipNulls, |
| encode ? encoder : null, |
| filter, |
| sort, |
| allowDots, |
| serializeDate, |
| formatter, |
| encodeValuesOnly |
| )); |
| } |
| |
| var joined = keys.join(delimiter); |
| var prefix = options.addQueryPrefix === true ? '?' : ''; |
| |
| return joined.length > 0 ? prefix + joined : ''; |
| }; |