3 var test = require('tape');
4 var qs = require('../');
5 var iconv = require('iconv-lite');
7 test('stringify()', function (t) {
8 t.test('stringifies a querystring object', function (st) {
9 st.equal(qs.stringify({ a: 'b' }), 'a=b');
10 st.equal(qs.stringify({ a: 1 }), 'a=1');
11 st.equal(qs.stringify({ a: 1, b: 2 }), 'a=1&b=2');
12 st.equal(qs.stringify({ a: 'A_Z' }), 'a=A_Z');
13 st.equal(qs.stringify({ a: 'β¬' }), 'a=%E2%82%AC');
14 st.equal(qs.stringify({ a: 'ξ' }), 'a=%EE%80%80');
15 st.equal(qs.stringify({ a: 'Χ' }), 'a=%D7%90');
16 st.equal(qs.stringify({ a: 'π·' }), 'a=%F0%90%90%B7');
20 t.test('stringifies a nested object', function (st) {
21 st.equal(qs.stringify({ a: { b: 'c' } }), 'a%5Bb%5D=c');
22 st.equal(qs.stringify({ a: { b: { c: { d: 'e' } } } }), 'a%5Bb%5D%5Bc%5D%5Bd%5D=e');
26 t.test('stringifies a nested object with dots notation', function (st) {
27 st.equal(qs.stringify({ a: { b: 'c' } }, { allowDots: true }), 'a.b=c');
28 st.equal(qs.stringify({ a: { b: { c: { d: 'e' } } } }, { allowDots: true }), 'a.b.c.d=e');
32 t.test('stringifies an array value', function (st) {
33 st.equal(qs.stringify({ a: ['b', 'c', 'd'] }), 'a%5B0%5D=b&a%5B1%5D=c&a%5B2%5D=d');
37 t.test('omits nulls when asked', function (st) {
38 st.equal(qs.stringify({ a: 'b', c: null }, { skipNulls: true }), 'a=b');
43 t.test('omits nested nulls when asked', function (st) {
44 st.equal(qs.stringify({ a: { b: 'c', d: null } }, { skipNulls: true }), 'a%5Bb%5D=c');
48 t.test('omits array indices when asked', function (st) {
49 st.equal(qs.stringify({ a: ['b', 'c', 'd'] }, { indices: false }), 'a=b&a=c&a=d');
53 t.test('stringifies a nested array value', function (st) {
54 st.equal(qs.stringify({ a: { b: ['c', 'd'] } }), 'a%5Bb%5D%5B0%5D=c&a%5Bb%5D%5B1%5D=d');
58 t.test('stringifies a nested array value with dots notation', function (st) {
59 st.equal(qs.stringify({ a: { b: ['c', 'd'] } }, { allowDots: true, encode: false }), 'a.b[0]=c&a.b[1]=d');
63 t.test('stringifies an object inside an array', function (st) {
64 st.equal(qs.stringify({ a: [{ b: 'c' }] }), 'a%5B0%5D%5Bb%5D=c');
65 st.equal(qs.stringify({ a: [{ b: { c: [1] } }] }), 'a%5B0%5D%5Bb%5D%5Bc%5D%5B0%5D=1');
69 t.test('stringifies an array with mixed objects and primitives', function (st) {
70 st.equal(qs.stringify({ a: [{ b: 1 }, 2, 3] }, { encode: false }), 'a[0][b]=1&a[1]=2&a[2]=3');
74 t.test('stringifies an object inside an array with dots notation', function (st) {
75 st.equal(qs.stringify({ a: [{ b: 'c' }] }, { allowDots: true, encode: false }), 'a[0].b=c');
76 st.equal(qs.stringify({ a: [{ b: { c: [1] } }] }, { allowDots: true, encode: false }), 'a[0].b.c[0]=1');
80 t.test('does not omit object keys when indices = false', function (st) {
81 st.equal(qs.stringify({ a: [{ b: 'c' }] }, { indices: false }), 'a%5Bb%5D=c');
85 t.test('uses indices notation for arrays when indices=true', function (st) {
86 st.equal(qs.stringify({ a: ['b', 'c'] }, { indices: true }), 'a%5B0%5D=b&a%5B1%5D=c');
90 t.test('uses indices notation for arrays when no arrayFormat is specified', function (st) {
91 st.equal(qs.stringify({ a: ['b', 'c'] }), 'a%5B0%5D=b&a%5B1%5D=c');
95 t.test('uses indices notation for arrays when no arrayFormat=indices', function (st) {
96 st.equal(qs.stringify({ a: ['b', 'c'] }, { arrayFormat: 'indices' }), 'a%5B0%5D=b&a%5B1%5D=c');
100 t.test('uses repeat notation for arrays when no arrayFormat=repeat', function (st) {
101 st.equal(qs.stringify({ a: ['b', 'c'] }, { arrayFormat: 'repeat' }), 'a=b&a=c');
105 t.test('uses brackets notation for arrays when no arrayFormat=brackets', function (st) {
106 st.equal(qs.stringify({ a: ['b', 'c'] }, { arrayFormat: 'brackets' }), 'a%5B%5D=b&a%5B%5D=c');
110 t.test('stringifies a complicated object', function (st) {
111 st.equal(qs.stringify({ a: { b: 'c', d: 'e' } }), 'a%5Bb%5D=c&a%5Bd%5D=e');
115 t.test('stringifies an empty value', function (st) {
116 st.equal(qs.stringify({ a: '' }), 'a=');
117 st.equal(qs.stringify({ a: null }, { strictNullHandling: true }), 'a');
119 st.equal(qs.stringify({ a: '', b: '' }), 'a=&b=');
120 st.equal(qs.stringify({ a: null, b: '' }, { strictNullHandling: true }), 'a&b=');
122 st.equal(qs.stringify({ a: { b: '' } }), 'a%5Bb%5D=');
123 st.equal(qs.stringify({ a: { b: null } }, { strictNullHandling: true }), 'a%5Bb%5D');
124 st.equal(qs.stringify({ a: { b: null } }, { strictNullHandling: false }), 'a%5Bb%5D=');
129 t.test('stringifies an empty object', function (st) {
130 var obj = Object.create(null);
132 st.equal(qs.stringify(obj), 'a=b');
136 t.test('returns an empty string for invalid input', function (st) {
137 st.equal(qs.stringify(undefined), '');
138 st.equal(qs.stringify(false), '');
139 st.equal(qs.stringify(null), '');
140 st.equal(qs.stringify(''), '');
144 t.test('stringifies an object with an empty object as a child', function (st) {
146 a: Object.create(null)
150 st.equal(qs.stringify(obj), 'a%5Bb%5D=c');
154 t.test('drops keys with a value of undefined', function (st) {
155 st.equal(qs.stringify({ a: undefined }), '');
157 st.equal(qs.stringify({ a: { b: undefined, c: null } }, { strictNullHandling: true }), 'a%5Bc%5D');
158 st.equal(qs.stringify({ a: { b: undefined, c: null } }, { strictNullHandling: false }), 'a%5Bc%5D=');
159 st.equal(qs.stringify({ a: { b: undefined, c: '' } }), 'a%5Bc%5D=');
163 t.test('url encodes values', function (st) {
164 st.equal(qs.stringify({ a: 'b c' }), 'a=b%20c');
168 t.test('stringifies a date', function (st) {
169 var now = new Date();
170 var str = 'a=' + encodeURIComponent(now.toISOString());
171 st.equal(qs.stringify({ a: now }), str);
175 t.test('stringifies the weird object from qs', function (st) {
176 st.equal(qs.stringify({ 'my weird field': '~q1!2"\'w$5&7/z8)?' }), 'my%20weird%20field=~q1%212%22%27w%245%267%2Fz8%29%3F');
180 t.test('skips properties that are part of the object prototype', function (st) {
181 Object.prototype.crash = 'test';
182 st.equal(qs.stringify({ a: 'b' }), 'a=b');
183 st.equal(qs.stringify({ a: { b: 'c' } }), 'a%5Bb%5D=c');
184 delete Object.prototype.crash;
188 t.test('stringifies boolean values', function (st) {
189 st.equal(qs.stringify({ a: true }), 'a=true');
190 st.equal(qs.stringify({ a: { b: true } }), 'a%5Bb%5D=true');
191 st.equal(qs.stringify({ b: false }), 'b=false');
192 st.equal(qs.stringify({ b: { c: false } }), 'b%5Bc%5D=false');
196 t.test('stringifies buffer values', function (st) {
197 st.equal(qs.stringify({ a: new Buffer('test') }), 'a=test');
198 st.equal(qs.stringify({ a: { b: new Buffer('test') } }), 'a%5Bb%5D=test');
202 t.test('stringifies an object using an alternative delimiter', function (st) {
203 st.equal(qs.stringify({ a: 'b', c: 'd' }, { delimiter: ';' }), 'a=b;c=d');
207 t.test('doesn\'t blow up when Buffer global is missing', function (st) {
208 var tempBuffer = global.Buffer;
209 delete global.Buffer;
210 var result = qs.stringify({ a: 'b', c: 'd' });
211 global.Buffer = tempBuffer;
212 st.equal(result, 'a=b&c=d');
216 t.test('selects properties when filter=array', function (st) {
217 st.equal(qs.stringify({ a: 'b' }, { filter: ['a'] }), 'a=b');
218 st.equal(qs.stringify({ a: 1 }, { filter: [] }), '');
219 st.equal(qs.stringify({ a: { b: [1, 2, 3, 4], c: 'd' }, c: 'f' }, { filter: ['a', 'b', 0, 2] }), 'a%5Bb%5D%5B0%5D=1&a%5Bb%5D%5B2%5D=3');
223 t.test('supports custom representations when filter=function', function (st) {
225 var obj = { a: 'b', c: 'd', e: { f: new Date(1257894000000) } };
226 var filterFunc = function (prefix, value) {
229 st.equal(prefix, '', 'prefix is empty');
230 st.equal(value, obj);
231 } else if (prefix === 'c') {
233 } else if (value instanceof Date) {
234 st.equal(prefix, 'e[f]');
235 return value.getTime();
240 st.equal(qs.stringify(obj, { filter: filterFunc }), 'a=b&e%5Bf%5D=1257894000000');
245 t.test('can disable uri encoding', function (st) {
246 st.equal(qs.stringify({ a: 'b' }, { encode: false }), 'a=b');
247 st.equal(qs.stringify({ a: { b: 'c' } }, { encode: false }), 'a[b]=c');
248 st.equal(qs.stringify({ a: 'b', c: null }, { strictNullHandling: true, encode: false }), 'a=b&c');
252 t.test('can sort the keys', function (st) {
253 var sort = function (a, b) { return a.localeCompare(b); };
254 st.equal(qs.stringify({ a: 'c', z: 'y', b: 'f' }, { sort: sort }), 'a=c&b=f&z=y');
255 st.equal(qs.stringify({ a: 'c', z: { j: 'a', i: 'b' }, b: 'f' }, { sort: sort }), 'a=c&b=f&z%5Bi%5D=b&z%5Bj%5D=a');
259 t.test('can sort the keys at depth 3 or more too', function (st) {
260 var sort = function (a, b) { return a.localeCompare(b); };
261 st.equal(qs.stringify({ a: 'a', z: { zj: {zjb: 'zjb', zja: 'zja'}, zi: {zib: 'zib', zia: 'zia'} }, b: 'b' }, { sort: sort, encode: false }), 'a=a&b=b&z[zi][zia]=zia&z[zi][zib]=zib&z[zj][zja]=zja&z[zj][zjb]=zjb');
262 st.equal(qs.stringify({ a: 'a', z: { zj: {zjb: 'zjb', zja: 'zja'}, zi: {zib: 'zib', zia: 'zia'} }, b: 'b' }, { sort: null, encode: false }), 'a=a&z[zj][zjb]=zjb&z[zj][zja]=zja&z[zi][zib]=zib&z[zi][zia]=zia&b=b');
266 t.test('can stringify with custom encoding', function (st) {
267 st.equal(qs.stringify({ η: '倧ιͺεΊ', '': ''}, {
268 encoder: function (str) {
269 if (str.length === 0) {
272 var buf = iconv.encode(str, 'shiftjis');
274 for (var i=0; i < buf.length; ++i) {
275 result.push(buf.readUInt8(i).toString(16));
277 return '%' + result.join('%');
279 }), '%8c%a7=%91%e5%8d%e3%95%7b&=');
283 t.test('throws error with wrong encoder', function (st) {
284 st.throws(function () {
288 }, new TypeError('Encoder has to be a function.'));
292 t.test('can use custom encoder for a buffer object', {
293 skip: typeof Buffer === 'undefined'
295 st.equal(qs.stringify({ a: new Buffer([1]) }, {
296 encoder: function (buffer) {
297 if (typeof buffer === 'string') {
300 return String.fromCharCode(buffer.readUInt8(0) + 97);