| // Load modules |
| |
| var Utils = require('./utils'); |
| |
| |
| // Declare internals |
| |
| var internals = { |
| delimiter: '&', |
| depth: 5, |
| arrayLimit: 20, |
| parameterLimit: 1000, |
| strictNullHandling: false, |
| plainObjects: false, |
| allowPrototypes: false |
| }; |
| |
| |
| internals.parseValues = function (str, options) { |
| |
| var obj = {}; |
| var parts = str.split(options.delimiter, options.parameterLimit === Infinity ? undefined : options.parameterLimit); |
| |
| for (var i = 0, il = parts.length; i < il; ++i) { |
| var part = parts[i]; |
| var pos = part.indexOf(']=') === -1 ? part.indexOf('=') : part.indexOf(']=') + 1; |
| |
| if (pos === -1) { |
| obj[Utils.decode(part)] = ''; |
| |
| if (options.strictNullHandling) { |
| obj[Utils.decode(part)] = null; |
| } |
| } |
| else { |
| var key = Utils.decode(part.slice(0, pos)); |
| var val = Utils.decode(part.slice(pos + 1)); |
| |
| if (!Object.prototype.hasOwnProperty.call(obj, key)) { |
| obj[key] = val; |
| } |
| else { |
| obj[key] = [].concat(obj[key]).concat(val); |
| } |
| } |
| } |
| |
| return obj; |
| }; |
| |
| |
| internals.parseObject = function (chain, val, options) { |
| |
| if (!chain.length) { |
| return val; |
| } |
| |
| var root = chain.shift(); |
| |
| var obj; |
| if (root === '[]') { |
| obj = []; |
| obj = obj.concat(internals.parseObject(chain, val, options)); |
| } |
| else { |
| obj = options.plainObjects ? Object.create(null) : {}; |
| var cleanRoot = root[0] === '[' && root[root.length - 1] === ']' ? root.slice(1, root.length - 1) : root; |
| var index = parseInt(cleanRoot, 10); |
| var indexString = '' + index; |
| if (!isNaN(index) && |
| root !== cleanRoot && |
| indexString === cleanRoot && |
| index >= 0 && |
| (options.parseArrays && |
| index <= options.arrayLimit)) { |
| |
| obj = []; |
| obj[index] = internals.parseObject(chain, val, options); |
| } |
| else { |
| obj[cleanRoot] = internals.parseObject(chain, val, options); |
| } |
| } |
| |
| return obj; |
| }; |
| |
| |
| internals.parseKeys = function (key, val, options) { |
| |
| if (!key) { |
| return; |
| } |
| |
| // Transform dot notation to bracket notation |
| |
| if (options.allowDots) { |
| key = key.replace(/\.([^\.\[]+)/g, '[$1]'); |
| } |
| |
| // The regex chunks |
| |
| var parent = /^([^\[\]]*)/; |
| var child = /(\[[^\[\]]*\])/g; |
| |
| // Get the parent |
| |
| var segment = parent.exec(key); |
| |
| // Stash the parent if it exists |
| |
| var keys = []; |
| if (segment[1]) { |
| // If we aren't using plain objects, optionally prefix keys |
| // that would overwrite object prototype properties |
| if (!options.plainObjects && |
| Object.prototype.hasOwnProperty(segment[1])) { |
| |
| if (!options.allowPrototypes) { |
| return; |
| } |
| } |
| |
| keys.push(segment[1]); |
| } |
| |
| // Loop through children appending to the array until we hit depth |
| |
| var i = 0; |
| while ((segment = child.exec(key)) !== null && i < options.depth) { |
| |
| ++i; |
| if (!options.plainObjects && |
| Object.prototype.hasOwnProperty(segment[1].replace(/\[|\]/g, ''))) { |
| |
| if (!options.allowPrototypes) { |
| continue; |
| } |
| } |
| keys.push(segment[1]); |
| } |
| |
| // If there's a remainder, just add whatever is left |
| |
| if (segment) { |
| keys.push('[' + key.slice(segment.index) + ']'); |
| } |
| |
| return internals.parseObject(keys, val, options); |
| }; |
| |
| |
| module.exports = function (str, options) { |
| |
| options = options || {}; |
| options.delimiter = typeof options.delimiter === 'string' || Utils.isRegExp(options.delimiter) ? options.delimiter : internals.delimiter; |
| options.depth = typeof options.depth === 'number' ? options.depth : internals.depth; |
| options.arrayLimit = typeof options.arrayLimit === 'number' ? options.arrayLimit : internals.arrayLimit; |
| options.parseArrays = options.parseArrays !== false; |
| options.allowDots = options.allowDots !== false; |
| options.plainObjects = typeof options.plainObjects === 'boolean' ? options.plainObjects : internals.plainObjects; |
| options.allowPrototypes = typeof options.allowPrototypes === 'boolean' ? options.allowPrototypes : internals.allowPrototypes; |
| options.parameterLimit = typeof options.parameterLimit === 'number' ? options.parameterLimit : internals.parameterLimit; |
| options.strictNullHandling = typeof options.strictNullHandling === 'boolean' ? options.strictNullHandling : internals.strictNullHandling; |
| |
| if (str === '' || |
| str === null || |
| typeof str === 'undefined') { |
| |
| return options.plainObjects ? Object.create(null) : {}; |
| } |
| |
| var tempObj = typeof str === 'string' ? internals.parseValues(str, options) : str; |
| var obj = options.plainObjects ? Object.create(null) : {}; |
| |
| // Iterate over the keys and setup the new object |
| |
| var keys = Object.keys(tempObj); |
| for (var i = 0, il = keys.length; i < il; ++i) { |
| var key = keys[i]; |
| var newObj = internals.parseKeys(key, tempObj[key], options); |
| obj = Utils.merge(obj, newObj, options); |
| } |
| |
| return Utils.compact(obj); |
| }; |