3 var utils = require('./utils');
4 var formats = require('./formats');
6 var arrayPrefixGenerators = {
7 brackets: function brackets(prefix) { // eslint-disable-line func-name-matching
10 indices: function indices(prefix, key) { // eslint-disable-line func-name-matching
11 return prefix + '[' + key + ']';
13 repeat: function repeat(prefix) { // eslint-disable-line func-name-matching
18 var toISO = Date.prototype.toISOString;
23 encoder: utils.encode,
24 encodeValuesOnly: false,
25 serializeDate: function serializeDate(date) { // eslint-disable-line func-name-matching
26 return toISO.call(date);
29 strictNullHandling: false
32 var stringify = function stringify( // eslint-disable-line func-name-matching
47 if (typeof filter === 'function') {
48 obj = filter(prefix, obj);
49 } else if (obj instanceof Date) {
50 obj = serializeDate(obj);
51 } else if (obj === null) {
52 if (strictNullHandling) {
53 return encoder && !encodeValuesOnly ? encoder(prefix, defaults.encoder) : prefix;
59 if (typeof obj === 'string' || typeof obj === 'number' || typeof obj === 'boolean' || utils.isBuffer(obj)) {
61 var keyValue = encodeValuesOnly ? prefix : encoder(prefix, defaults.encoder);
62 return [formatter(keyValue) + '=' + formatter(encoder(obj, defaults.encoder))];
64 return [formatter(prefix) + '=' + formatter(String(obj))];
69 if (typeof obj === 'undefined') {
74 if (Array.isArray(filter)) {
77 var keys = Object.keys(obj);
78 objKeys = sort ? keys.sort(sort) : keys;
81 for (var i = 0; i < objKeys.length; ++i) {
84 if (skipNulls && obj[key] === null) {
88 if (Array.isArray(obj)) {
89 values = values.concat(stringify(
91 generateArrayPrefix(prefix, key),
104 values = values.concat(stringify(
106 prefix + (allowDots ? '.' + key : '[' + key + ']'),
124 module.exports = function (object, opts) {
126 var options = opts ? utils.assign({}, opts) : {};
128 if (options.encoder !== null && options.encoder !== undefined && typeof options.encoder !== 'function') {
129 throw new TypeError('Encoder has to be a function.');
132 var delimiter = typeof options.delimiter === 'undefined' ? defaults.delimiter : options.delimiter;
133 var strictNullHandling = typeof options.strictNullHandling === 'boolean' ? options.strictNullHandling : defaults.strictNullHandling;
134 var skipNulls = typeof options.skipNulls === 'boolean' ? options.skipNulls : defaults.skipNulls;
135 var encode = typeof options.encode === 'boolean' ? options.encode : defaults.encode;
136 var encoder = typeof options.encoder === 'function' ? options.encoder : defaults.encoder;
137 var sort = typeof options.sort === 'function' ? options.sort : null;
138 var allowDots = typeof options.allowDots === 'undefined' ? false : options.allowDots;
139 var serializeDate = typeof options.serializeDate === 'function' ? options.serializeDate : defaults.serializeDate;
140 var encodeValuesOnly = typeof options.encodeValuesOnly === 'boolean' ? options.encodeValuesOnly : defaults.encodeValuesOnly;
141 if (typeof options.format === 'undefined') {
142 options.format = formats['default'];
143 } else if (!Object.prototype.hasOwnProperty.call(formats.formatters, options.format)) {
144 throw new TypeError('Unknown format option provided.');
146 var formatter = formats.formatters[options.format];
150 if (typeof options.filter === 'function') {
151 filter = options.filter;
152 obj = filter('', obj);
153 } else if (Array.isArray(options.filter)) {
154 filter = options.filter;
160 if (typeof obj !== 'object' || obj === null) {
165 if (options.arrayFormat in arrayPrefixGenerators) {
166 arrayFormat = options.arrayFormat;
167 } else if ('indices' in options) {
168 arrayFormat = options.indices ? 'indices' : 'repeat';
170 arrayFormat = 'indices';
173 var generateArrayPrefix = arrayPrefixGenerators[arrayFormat];
176 objKeys = Object.keys(obj);
183 for (var i = 0; i < objKeys.length; ++i) {
184 var key = objKeys[i];
186 if (skipNulls && obj[key] === null) {
190 keys = keys.concat(stringify(
196 encode ? encoder : null,
206 var joined = keys.join(delimiter);
207 var prefix = options.addQueryPrefix === true ? '?' : '';
209 return joined.length > 0 ? prefix + joined : '';