| // Load modules |
| |
| var Utils = require('./utils'); |
| |
| |
| // Declare internals |
| |
| var internals = { |
| delimiter: '&', |
| arrayPrefixGenerators: { |
| brackets: function (prefix, key) { |
| |
| return prefix + '[]'; |
| }, |
| indices: function (prefix, key) { |
| |
| return prefix + '[' + key + ']'; |
| }, |
| repeat: function (prefix, key) { |
| |
| return prefix; |
| } |
| }, |
| strictNullHandling: false |
| }; |
| |
| |
| internals.stringify = function (obj, prefix, generateArrayPrefix, strictNullHandling, filter) { |
| |
| if (typeof filter === 'function') { |
| obj = filter(prefix, obj); |
| } |
| else if (Utils.isBuffer(obj)) { |
| obj = obj.toString(); |
| } |
| else if (obj instanceof Date) { |
| obj = obj.toISOString(); |
| } |
| else if (obj === null) { |
| if (strictNullHandling) { |
| return Utils.encode(prefix); |
| } |
| |
| obj = ''; |
| } |
| |
| if (typeof obj === 'string' || |
| typeof obj === 'number' || |
| typeof obj === 'boolean') { |
| |
| return [Utils.encode(prefix) + '=' + Utils.encode(obj)]; |
| } |
| |
| var values = []; |
| |
| if (typeof obj === 'undefined') { |
| return values; |
| } |
| |
| var objKeys = Array.isArray(filter) ? filter : Object.keys(obj); |
| for (var i = 0, il = objKeys.length; i < il; ++i) { |
| var key = objKeys[i]; |
| |
| if (Array.isArray(obj)) { |
| values = values.concat(internals.stringify(obj[key], generateArrayPrefix(prefix, key), generateArrayPrefix, strictNullHandling, filter)); |
| } |
| else { |
| values = values.concat(internals.stringify(obj[key], prefix + '[' + key + ']', generateArrayPrefix, strictNullHandling, filter)); |
| } |
| } |
| |
| return values; |
| }; |
| |
| |
| module.exports = function (obj, options) { |
| |
| options = options || {}; |
| var delimiter = typeof options.delimiter === 'undefined' ? internals.delimiter : options.delimiter; |
| var strictNullHandling = typeof options.strictNullHandling === 'boolean' ? options.strictNullHandling : internals.strictNullHandling; |
| var objKeys; |
| var filter; |
| if (typeof options.filter === 'function') { |
| filter = options.filter; |
| obj = filter('', obj); |
| } |
| else if (Array.isArray(options.filter)) { |
| objKeys = filter = options.filter; |
| } |
| |
| var keys = []; |
| |
| if (typeof obj !== 'object' || |
| obj === null) { |
| |
| return ''; |
| } |
| |
| var arrayFormat; |
| if (options.arrayFormat in internals.arrayPrefixGenerators) { |
| arrayFormat = options.arrayFormat; |
| } |
| else if ('indices' in options) { |
| arrayFormat = options.indices ? 'indices' : 'repeat'; |
| } |
| else { |
| arrayFormat = 'indices'; |
| } |
| |
| var generateArrayPrefix = internals.arrayPrefixGenerators[arrayFormat]; |
| |
| if (!objKeys) { |
| objKeys = Object.keys(obj); |
| } |
| for (var i = 0, il = objKeys.length; i < il; ++i) { |
| var key = objKeys[i]; |
| keys = keys.concat(internals.stringify(obj[key], key, generateArrayPrefix, strictNullHandling, filter)); |
| } |
| |
| return keys.join(delimiter); |
| }; |