3 var test = require('tape');
4 var qs = require('../');
5 var iconv = require('iconv-lite');
7 test('parse()', function (t) {
8 t.test('parses a simple string', function (st) {
9 st.deepEqual(qs.parse('0=foo'), { 0: 'foo' });
10 st.deepEqual(qs.parse('foo=c++'), { foo: 'c ' });
11 st.deepEqual(qs.parse('a[>=]=23'), { a: { '>=': '23' } });
12 st.deepEqual(qs.parse('a[<=>]==23'), { a: { '<=>': '=23' } });
13 st.deepEqual(qs.parse('a[==]=23'), { a: { '==': '23' } });
14 st.deepEqual(qs.parse('foo', { strictNullHandling: true }), { foo: null });
15 st.deepEqual(qs.parse('foo'), { foo: '' });
16 st.deepEqual(qs.parse('foo='), { foo: '' });
17 st.deepEqual(qs.parse('foo=bar'), { foo: 'bar' });
18 st.deepEqual(qs.parse(' foo = bar = baz '), { ' foo ': ' bar = baz ' });
19 st.deepEqual(qs.parse('foo=bar=baz'), { foo: 'bar=baz' });
20 st.deepEqual(qs.parse('foo=bar&bar=baz'), { foo: 'bar', bar: 'baz' });
21 st.deepEqual(qs.parse('foo2=bar2&baz2='), { foo2: 'bar2', baz2: '' });
22 st.deepEqual(qs.parse('foo=bar&baz', { strictNullHandling: true }), { foo: 'bar', baz: null });
23 st.deepEqual(qs.parse('foo=bar&baz'), { foo: 'bar', baz: '' });
24 st.deepEqual(qs.parse('cht=p3&chd=t:60,40&chs=250x100&chl=Hello|World'), {
33 t.test('allows enabling dot notation', function (st) {
34 st.deepEqual(qs.parse('a.b=c'), { 'a.b': 'c' });
35 st.deepEqual(qs.parse('a.b=c', { allowDots: true }), { a: { b: 'c' } });
39 t.deepEqual(qs.parse('a[b]=c'), { a: { b: 'c' } }, 'parses a single nested string');
40 t.deepEqual(qs.parse('a[b][c]=d'), { a: { b: { c: 'd' } } }, 'parses a double nested string');
42 qs.parse('a[b][c][d][e][f][g][h]=i'),
43 { a: { b: { c: { d: { e: { f: { '[g][h]': 'i' } } } } } } },
44 'defaults to a depth of 5'
47 t.test('only parses one level when depth = 1', function (st) {
48 st.deepEqual(qs.parse('a[b][c]=d', { depth: 1 }), { a: { b: { '[c]': 'd' } } });
49 st.deepEqual(qs.parse('a[b][c][d]=e', { depth: 1 }), { a: { b: { '[c][d]': 'e' } } });
53 t.deepEqual(qs.parse('a=b&a=c'), { a: ['b', 'c'] }, 'parses a simple array');
55 t.test('parses an explicit array', function (st) {
56 st.deepEqual(qs.parse('a[]=b'), { a: ['b'] });
57 st.deepEqual(qs.parse('a[]=b&a[]=c'), { a: ['b', 'c'] });
58 st.deepEqual(qs.parse('a[]=b&a[]=c&a[]=d'), { a: ['b', 'c', 'd'] });
62 t.test('parses a mix of simple and explicit arrays', function (st) {
63 st.deepEqual(qs.parse('a=b&a[]=c'), { a: ['b', 'c'] });
64 st.deepEqual(qs.parse('a[]=b&a=c'), { a: ['b', 'c'] });
65 st.deepEqual(qs.parse('a[0]=b&a=c'), { a: ['b', 'c'] });
66 st.deepEqual(qs.parse('a=b&a[0]=c'), { a: ['b', 'c'] });
68 st.deepEqual(qs.parse('a[1]=b&a=c', { arrayLimit: 20 }), { a: ['b', 'c'] });
69 st.deepEqual(qs.parse('a[]=b&a=c', { arrayLimit: 0 }), { a: ['b', 'c'] });
70 st.deepEqual(qs.parse('a[]=b&a=c'), { a: ['b', 'c'] });
72 st.deepEqual(qs.parse('a=b&a[1]=c', { arrayLimit: 20 }), { a: ['b', 'c'] });
73 st.deepEqual(qs.parse('a=b&a[]=c', { arrayLimit: 0 }), { a: ['b', 'c'] });
74 st.deepEqual(qs.parse('a=b&a[]=c'), { a: ['b', 'c'] });
79 t.test('parses a nested array', function (st) {
80 st.deepEqual(qs.parse('a[b][]=c&a[b][]=d'), { a: { b: ['c', 'd'] } });
81 st.deepEqual(qs.parse('a[>=]=25'), { a: { '>=': '25' } });
85 t.test('allows to specify array indices', function (st) {
86 st.deepEqual(qs.parse('a[1]=c&a[0]=b&a[2]=d'), { a: ['b', 'c', 'd'] });
87 st.deepEqual(qs.parse('a[1]=c&a[0]=b'), { a: ['b', 'c'] });
88 st.deepEqual(qs.parse('a[1]=c', { arrayLimit: 20 }), { a: ['c'] });
89 st.deepEqual(qs.parse('a[1]=c', { arrayLimit: 0 }), { a: { 1: 'c' } });
90 st.deepEqual(qs.parse('a[1]=c'), { a: ['c'] });
94 t.test('limits specific array indices to arrayLimit', function (st) {
95 st.deepEqual(qs.parse('a[20]=a', { arrayLimit: 20 }), { a: ['a'] });
96 st.deepEqual(qs.parse('a[21]=a', { arrayLimit: 20 }), { a: { 21: 'a' } });
100 t.deepEqual(qs.parse('a[12b]=c'), { a: { '12b': 'c' } }, 'supports keys that begin with a number');
102 t.test('supports encoded = signs', function (st) {
103 st.deepEqual(qs.parse('he%3Dllo=th%3Dere'), { 'he=llo': 'th=ere' });
107 t.test('is ok with url encoded strings', function (st) {
108 st.deepEqual(qs.parse('a[b%20c]=d'), { a: { 'b c': 'd' } });
109 st.deepEqual(qs.parse('a[b]=c%20d'), { a: { b: 'c d' } });
113 t.test('allows brackets in the value', function (st) {
114 st.deepEqual(qs.parse('pets=["tobi"]'), { pets: '["tobi"]' });
115 st.deepEqual(qs.parse('operators=[">=", "<="]'), { operators: '[">=", "<="]' });
119 t.test('allows empty values', function (st) {
120 st.deepEqual(qs.parse(''), {});
121 st.deepEqual(qs.parse(null), {});
122 st.deepEqual(qs.parse(undefined), {});
126 t.test('transforms arrays to objects', function (st) {
127 st.deepEqual(qs.parse('foo[0]=bar&foo[bad]=baz'), { foo: { 0: 'bar', bad: 'baz' } });
128 st.deepEqual(qs.parse('foo[bad]=baz&foo[0]=bar'), { foo: { bad: 'baz', 0: 'bar' } });
129 st.deepEqual(qs.parse('foo[bad]=baz&foo[]=bar'), { foo: { bad: 'baz', 0: 'bar' } });
130 st.deepEqual(qs.parse('foo[]=bar&foo[bad]=baz'), { foo: { 0: 'bar', bad: 'baz' } });
131 st.deepEqual(qs.parse('foo[bad]=baz&foo[]=bar&foo[]=foo'), { foo: { bad: 'baz', 0: 'bar', 1: 'foo' } });
132 st.deepEqual(qs.parse('foo[0][a]=a&foo[0][b]=b&foo[1][a]=aa&foo[1][b]=bb'), { foo: [{ a: 'a', b: 'b' }, { a: 'aa', b: 'bb' }] });
134 st.deepEqual(qs.parse('a[]=b&a[t]=u&a[hasOwnProperty]=c', { allowPrototypes: false }), { a: { 0: 'b', t: 'u' } });
135 st.deepEqual(qs.parse('a[]=b&a[t]=u&a[hasOwnProperty]=c', { allowPrototypes: true }), { a: { 0: 'b', t: 'u', hasOwnProperty: 'c' } });
136 st.deepEqual(qs.parse('a[]=b&a[hasOwnProperty]=c&a[x]=y', { allowPrototypes: false }), { a: { 0: 'b', x: 'y' } });
137 st.deepEqual(qs.parse('a[]=b&a[hasOwnProperty]=c&a[x]=y', { allowPrototypes: true }), { a: { 0: 'b', hasOwnProperty: 'c', x: 'y' } });
141 t.test('transforms arrays to objects (dot notation)', function (st) {
142 st.deepEqual(qs.parse('foo[0].baz=bar&fool.bad=baz', { allowDots: true }), { foo: [{ baz: 'bar' }], fool: { bad: 'baz' } });
143 st.deepEqual(qs.parse('foo[0].baz=bar&fool.bad.boo=baz', { allowDots: true }), { foo: [{ baz: 'bar' }], fool: { bad: { boo: 'baz' } } });
144 st.deepEqual(qs.parse('foo[0][0].baz=bar&fool.bad=baz', { allowDots: true }), { foo: [[{ baz: 'bar' }]], fool: { bad: 'baz' } });
145 st.deepEqual(qs.parse('foo[0].baz[0]=15&foo[0].bar=2', { allowDots: true }), { foo: [{ baz: ['15'], bar: '2' }] });
146 st.deepEqual(qs.parse('foo[0].baz[0]=15&foo[0].baz[1]=16&foo[0].bar=2', { allowDots: true }), { foo: [{ baz: ['15', '16'], bar: '2' }] });
147 st.deepEqual(qs.parse('foo.bad=baz&foo[0]=bar', { allowDots: true }), { foo: { bad: 'baz', 0: 'bar' } });
148 st.deepEqual(qs.parse('foo.bad=baz&foo[]=bar', { allowDots: true }), { foo: { bad: 'baz', 0: 'bar' } });
149 st.deepEqual(qs.parse('foo[]=bar&foo.bad=baz', { allowDots: true }), { foo: { 0: 'bar', bad: 'baz' } });
150 st.deepEqual(qs.parse('foo.bad=baz&foo[]=bar&foo[]=foo', { allowDots: true }), { foo: { bad: 'baz', 0: 'bar', 1: 'foo' } });
151 st.deepEqual(qs.parse('foo[0].a=a&foo[0].b=b&foo[1].a=aa&foo[1].b=bb', { allowDots: true }), { foo: [{ a: 'a', b: 'b' }, { a: 'aa', b: 'bb' }] });
155 t.test('correctly prunes undefined values when converting an array to an object', function (st) {
156 st.deepEqual(qs.parse('a[2]=b&a[99999999]=c'), { a: { 2: 'b', 99999999: 'c' } });
160 t.test('supports malformed uri characters', function (st) {
161 st.deepEqual(qs.parse('{%:%}', { strictNullHandling: true }), { '{%:%}': null });
162 st.deepEqual(qs.parse('{%:%}='), { '{%:%}': '' });
163 st.deepEqual(qs.parse('foo=%:%}'), { foo: '%:%}' });
167 t.test('doesn\'t produce empty keys', function (st) {
168 st.deepEqual(qs.parse('_r=1&'), { _r: '1' });
172 t.test('cannot access Object prototype', function (st) {
173 qs.parse('constructor[prototype][bad]=bad');
174 qs.parse('bad[constructor][prototype][bad]=bad');
175 st.equal(typeof Object.prototype.bad, 'undefined');
179 t.test('parses arrays of objects', function (st) {
180 st.deepEqual(qs.parse('a[][b]=c'), { a: [{ b: 'c' }] });
181 st.deepEqual(qs.parse('a[0][b]=c'), { a: [{ b: 'c' }] });
185 t.test('allows for empty strings in arrays', function (st) {
186 st.deepEqual(qs.parse('a[]=b&a[]=&a[]=c'), { a: ['b', '', 'c'] });
189 qs.parse('a[0]=b&a[1]&a[2]=c&a[19]=', { strictNullHandling: true, arrayLimit: 20 }),
190 { a: ['b', null, 'c', ''] },
191 'with arrayLimit 20 + array indices: null then empty string works'
194 qs.parse('a[]=b&a[]&a[]=c&a[]=', { strictNullHandling: true, arrayLimit: 0 }),
195 { a: ['b', null, 'c', ''] },
196 'with arrayLimit 0 + array brackets: null then empty string works'
200 qs.parse('a[0]=b&a[1]=&a[2]=c&a[19]', { strictNullHandling: true, arrayLimit: 20 }),
201 { a: ['b', '', 'c', null] },
202 'with arrayLimit 20 + array indices: empty string then null works'
205 qs.parse('a[]=b&a[]=&a[]=c&a[]', { strictNullHandling: true, arrayLimit: 0 }),
206 { a: ['b', '', 'c', null] },
207 'with arrayLimit 0 + array brackets: empty string then null works'
211 qs.parse('a[]=&a[]=b&a[]=c'),
212 { a: ['', 'b', 'c'] },
213 'array brackets: empty strings work'
218 t.test('compacts sparse arrays', function (st) {
219 st.deepEqual(qs.parse('a[10]=1&a[2]=2', { arrayLimit: 20 }), { a: ['2', '1'] });
220 st.deepEqual(qs.parse('a[1][b][2][c]=1', { arrayLimit: 20 }), { a: [{ b: [{ c: '1' }] }] });
221 st.deepEqual(qs.parse('a[1][2][3][c]=1', { arrayLimit: 20 }), { a: [[[{ c: '1' }]]] });
222 st.deepEqual(qs.parse('a[1][2][3][c][1]=1', { arrayLimit: 20 }), { a: [[[{ c: ['1'] }]]] });
226 t.test('parses semi-parsed strings', function (st) {
227 st.deepEqual(qs.parse({ 'a[b]': 'c' }), { a: { b: 'c' } });
228 st.deepEqual(qs.parse({ 'a[b]': 'c', 'a[d]': 'e' }), { a: { b: 'c', d: 'e' } });
232 t.test('parses buffers correctly', function (st) {
233 var b = new Buffer('test');
234 st.deepEqual(qs.parse({ a: b }), { a: b });
238 t.test('continues parsing when no parent is found', function (st) {
239 st.deepEqual(qs.parse('[]=&a=b'), { 0: '', a: 'b' });
240 st.deepEqual(qs.parse('[]&a=b', { strictNullHandling: true }), { 0: null, a: 'b' });
241 st.deepEqual(qs.parse('[foo]=bar'), { foo: 'bar' });
245 t.test('does not error when parsing a very long array', function (st) {
247 while (Buffer.byteLength(str) < 128 * 1024) {
248 str = str + '&' + str;
251 st.doesNotThrow(function () {
258 t.test('should not throw when a native prototype has an enumerable property', { parallel: false }, function (st) {
259 Object.prototype.crash = '';
260 Array.prototype.crash = '';
261 st.doesNotThrow(qs.parse.bind(null, 'a=b'));
262 st.deepEqual(qs.parse('a=b'), { a: 'b' });
263 st.doesNotThrow(qs.parse.bind(null, 'a[][b]=c'));
264 st.deepEqual(qs.parse('a[][b]=c'), { a: [{ b: 'c' }] });
265 delete Object.prototype.crash;
266 delete Array.prototype.crash;
270 t.test('parses a string with an alternative string delimiter', function (st) {
271 st.deepEqual(qs.parse('a=b;c=d', { delimiter: ';' }), { a: 'b', c: 'd' });
275 t.test('parses a string with an alternative RegExp delimiter', function (st) {
276 st.deepEqual(qs.parse('a=b; c=d', { delimiter: /[;,] */ }), { a: 'b', c: 'd' });
280 t.test('does not use non-splittable objects as delimiters', function (st) {
281 st.deepEqual(qs.parse('a=b&c=d', { delimiter: true }), { a: 'b', c: 'd' });
285 t.test('allows overriding parameter limit', function (st) {
286 st.deepEqual(qs.parse('a=b&c=d', { parameterLimit: 1 }), { a: 'b' });
290 t.test('allows setting the parameter limit to Infinity', function (st) {
291 st.deepEqual(qs.parse('a=b&c=d', { parameterLimit: Infinity }), { a: 'b', c: 'd' });
295 t.test('allows overriding array limit', function (st) {
296 st.deepEqual(qs.parse('a[0]=b', { arrayLimit: -1 }), { a: { 0: 'b' } });
297 st.deepEqual(qs.parse('a[-1]=b', { arrayLimit: -1 }), { a: { '-1': 'b' } });
298 st.deepEqual(qs.parse('a[0]=b&a[1]=c', { arrayLimit: 0 }), { a: { 0: 'b', 1: 'c' } });
302 t.test('allows disabling array parsing', function (st) {
303 st.deepEqual(qs.parse('a[0]=b&a[1]=c', { parseArrays: false }), { a: { 0: 'b', 1: 'c' } });
307 t.test('parses an object', function (st) {
309 'user[name]': { 'pop[bob]': 3 },
315 name: { 'pop[bob]': 3 },
320 var result = qs.parse(input);
322 st.deepEqual(result, expected);
326 t.test('parses an object in dot notation', function (st) {
328 'user.name': { 'pop[bob]': 3 },
334 name: { 'pop[bob]': 3 },
339 var result = qs.parse(input, { allowDots: true });
341 st.deepEqual(result, expected);
345 t.test('parses an object and not child values', function (st) {
347 'user[name]': { 'pop[bob]': { test: 3 } },
353 name: { 'pop[bob]': { test: 3 } },
358 var result = qs.parse(input);
360 st.deepEqual(result, expected);
364 t.test('does not blow up when Buffer global is missing', function (st) {
365 var tempBuffer = global.Buffer;
366 delete global.Buffer;
367 var result = qs.parse('a=b&c=d');
368 global.Buffer = tempBuffer;
369 st.deepEqual(result, { a: 'b', c: 'd' });
373 t.test('does not crash when parsing circular references', function (st) {
379 st.doesNotThrow(function () {
380 parsed = qs.parse({ 'foo[bar]': 'baz', 'foo[baz]': a });
383 st.equal('foo' in parsed, true, 'parsed has "foo" property');
384 st.equal('bar' in parsed.foo, true);
385 st.equal('baz' in parsed.foo, true);
386 st.equal(parsed.foo.bar, 'baz');
387 st.deepEqual(parsed.foo.baz, a);
391 t.test('parses null objects correctly', { skip: !Object.create }, function (st) {
392 var a = Object.create(null);
395 st.deepEqual(qs.parse(a), { b: 'c' });
396 var result = qs.parse({ a: a });
397 st.equal('a' in result, true, 'result has "a" property');
398 st.deepEqual(result.a, a);
402 t.test('parses dates correctly', function (st) {
403 var now = new Date();
404 st.deepEqual(qs.parse({ a: now }), { a: now });
408 t.test('parses regular expressions correctly', function (st) {
410 st.deepEqual(qs.parse({ a: re }), { a: re });
414 t.test('does not allow overwriting prototype properties', function (st) {
415 st.deepEqual(qs.parse('a[hasOwnProperty]=b', { allowPrototypes: false }), {});
416 st.deepEqual(qs.parse('hasOwnProperty=b', { allowPrototypes: false }), {});
419 qs.parse('toString', { allowPrototypes: false }),
421 'bare "toString" results in {}'
427 t.test('can allow overwriting prototype properties', function (st) {
428 st.deepEqual(qs.parse('a[hasOwnProperty]=b', { allowPrototypes: true }), { a: { hasOwnProperty: 'b' } });
429 st.deepEqual(qs.parse('hasOwnProperty=b', { allowPrototypes: true }), { hasOwnProperty: 'b' });
432 qs.parse('toString', { allowPrototypes: true }),
434 'bare "toString" results in { toString: "" }'
440 t.test('params starting with a closing bracket', function (st) {
441 st.deepEqual(qs.parse(']=toString'), { ']': 'toString' });
442 st.deepEqual(qs.parse(']]=toString'), { ']]': 'toString' });
443 st.deepEqual(qs.parse(']hello]=toString'), { ']hello]': 'toString' });
447 t.test('params starting with a starting bracket', function (st) {
448 st.deepEqual(qs.parse('[=toString'), { '[': 'toString' });
449 st.deepEqual(qs.parse('[[=toString'), { '[[': 'toString' });
450 st.deepEqual(qs.parse('[hello[=toString'), { '[hello[': 'toString' });
454 t.test('add keys to objects', function (st) {
456 qs.parse('a[b]=c&a=d'),
457 { a: { b: 'c', d: true } },
458 'can add keys to objects'
462 qs.parse('a[b]=c&a=toString'),
464 'can not overwrite prototype'
468 qs.parse('a[b]=c&a=toString', { allowPrototypes: true }),
469 { a: { b: 'c', toString: true } },
470 'can overwrite prototype with allowPrototypes true'
474 qs.parse('a[b]=c&a=toString', { plainObjects: true }),
475 { a: { b: 'c', toString: true } },
476 'can overwrite prototype with plainObjects true'
482 t.test('can return null objects', { skip: !Object.create }, function (st) {
483 var expected = Object.create(null);
484 expected.a = Object.create(null);
486 expected.a.hasOwnProperty = 'd';
487 st.deepEqual(qs.parse('a[b]=c&a[hasOwnProperty]=d', { plainObjects: true }), expected);
488 st.deepEqual(qs.parse(null, { plainObjects: true }), Object.create(null));
489 var expectedArray = Object.create(null);
490 expectedArray.a = Object.create(null);
491 expectedArray.a[0] = 'b';
492 expectedArray.a.c = 'd';
493 st.deepEqual(qs.parse('a[]=b&a[c]=d', { plainObjects: true }), expectedArray);
497 t.test('can parse with custom encoding', function (st) {
498 st.deepEqual(qs.parse('%8c%a7=%91%e5%8d%e3%95%7b', {
499 decoder: function (str) {
500 var reg = /%([0-9A-F]{2})/ig;
502 var parts = reg.exec(str);
504 result.push(parseInt(parts[1], 16));
505 parts = reg.exec(str);
507 return iconv.decode(new Buffer(result), 'shift_jis').toString();
513 t.test('throws error with wrong decoder', function (st) {
514 st.throws(function () {
515 qs.parse({}, { decoder: 'string' });
516 }, new TypeError('Decoder has to be a function.'));