Node-Red configuration
Nelze vybrat více než 25 témat Téma musí začínat písmenem nebo číslem, může obsahovat pomlčky („-“) a může být dlouhé až 35 znaků.

stringify.js 34KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909
  1. 'use strict';
  2. var test = require('tape');
  3. var qs = require('../');
  4. var utils = require('../lib/utils');
  5. var iconv = require('iconv-lite');
  6. var SaferBuffer = require('safer-buffer').Buffer;
  7. var hasSymbols = require('has-symbols');
  8. var hasBigInt = typeof BigInt === 'function';
  9. test('stringify()', function (t) {
  10. t.test('stringifies a querystring object', function (st) {
  11. st.equal(qs.stringify({ a: 'b' }), 'a=b');
  12. st.equal(qs.stringify({ a: 1 }), 'a=1');
  13. st.equal(qs.stringify({ a: 1, b: 2 }), 'a=1&b=2');
  14. st.equal(qs.stringify({ a: 'A_Z' }), 'a=A_Z');
  15. st.equal(qs.stringify({ a: '€' }), 'a=%E2%82%AC');
  16. st.equal(qs.stringify({ a: '' }), 'a=%EE%80%80');
  17. st.equal(qs.stringify({ a: 'א' }), 'a=%D7%90');
  18. st.equal(qs.stringify({ a: '𐐷' }), 'a=%F0%90%90%B7');
  19. st.end();
  20. });
  21. t.test('stringifies falsy values', function (st) {
  22. st.equal(qs.stringify(undefined), '');
  23. st.equal(qs.stringify(null), '');
  24. st.equal(qs.stringify(null, { strictNullHandling: true }), '');
  25. st.equal(qs.stringify(false), '');
  26. st.equal(qs.stringify(0), '');
  27. st.end();
  28. });
  29. t.test('stringifies symbols', { skip: !hasSymbols() }, function (st) {
  30. st.equal(qs.stringify(Symbol.iterator), '');
  31. st.equal(qs.stringify([Symbol.iterator]), '0=Symbol%28Symbol.iterator%29');
  32. st.equal(qs.stringify({ a: Symbol.iterator }), 'a=Symbol%28Symbol.iterator%29');
  33. st.equal(
  34. qs.stringify({ a: [Symbol.iterator] }, { encodeValuesOnly: true, arrayFormat: 'brackets' }),
  35. 'a[]=Symbol%28Symbol.iterator%29'
  36. );
  37. st.end();
  38. });
  39. t.test('stringifies bigints', { skip: !hasBigInt }, function (st) {
  40. var three = BigInt(3);
  41. var encodeWithN = function (value, defaultEncoder, charset) {
  42. var result = defaultEncoder(value, defaultEncoder, charset);
  43. return typeof value === 'bigint' ? result + 'n' : result;
  44. };
  45. st.equal(qs.stringify(three), '');
  46. st.equal(qs.stringify([three]), '0=3');
  47. st.equal(qs.stringify([three], { encoder: encodeWithN }), '0=3n');
  48. st.equal(qs.stringify({ a: three }), 'a=3');
  49. st.equal(qs.stringify({ a: three }, { encoder: encodeWithN }), 'a=3n');
  50. st.equal(
  51. qs.stringify({ a: [three] }, { encodeValuesOnly: true, arrayFormat: 'brackets' }),
  52. 'a[]=3'
  53. );
  54. st.equal(
  55. qs.stringify({ a: [three] }, { encodeValuesOnly: true, encoder: encodeWithN, arrayFormat: 'brackets' }),
  56. 'a[]=3n'
  57. );
  58. st.end();
  59. });
  60. t.test('adds query prefix', function (st) {
  61. st.equal(qs.stringify({ a: 'b' }, { addQueryPrefix: true }), '?a=b');
  62. st.end();
  63. });
  64. t.test('with query prefix, outputs blank string given an empty object', function (st) {
  65. st.equal(qs.stringify({}, { addQueryPrefix: true }), '');
  66. st.end();
  67. });
  68. t.test('stringifies nested falsy values', function (st) {
  69. st.equal(qs.stringify({ a: { b: { c: null } } }), 'a%5Bb%5D%5Bc%5D=');
  70. st.equal(qs.stringify({ a: { b: { c: null } } }, { strictNullHandling: true }), 'a%5Bb%5D%5Bc%5D');
  71. st.equal(qs.stringify({ a: { b: { c: false } } }), 'a%5Bb%5D%5Bc%5D=false');
  72. st.end();
  73. });
  74. t.test('stringifies a nested object', function (st) {
  75. st.equal(qs.stringify({ a: { b: 'c' } }), 'a%5Bb%5D=c');
  76. st.equal(qs.stringify({ a: { b: { c: { d: 'e' } } } }), 'a%5Bb%5D%5Bc%5D%5Bd%5D=e');
  77. st.end();
  78. });
  79. t.test('stringifies a nested object with dots notation', function (st) {
  80. st.equal(qs.stringify({ a: { b: 'c' } }, { allowDots: true }), 'a.b=c');
  81. st.equal(qs.stringify({ a: { b: { c: { d: 'e' } } } }, { allowDots: true }), 'a.b.c.d=e');
  82. st.end();
  83. });
  84. t.test('stringifies an array value', function (st) {
  85. st.equal(
  86. qs.stringify({ a: ['b', 'c', 'd'] }, { arrayFormat: 'indices' }),
  87. 'a%5B0%5D=b&a%5B1%5D=c&a%5B2%5D=d',
  88. 'indices => indices'
  89. );
  90. st.equal(
  91. qs.stringify({ a: ['b', 'c', 'd'] }, { arrayFormat: 'brackets' }),
  92. 'a%5B%5D=b&a%5B%5D=c&a%5B%5D=d',
  93. 'brackets => brackets'
  94. );
  95. st.equal(
  96. qs.stringify({ a: ['b', 'c', 'd'] }, { arrayFormat: 'comma' }),
  97. 'a=b%2Cc%2Cd',
  98. 'comma => comma'
  99. );
  100. st.equal(
  101. qs.stringify({ a: ['b', 'c', 'd'] }),
  102. 'a%5B0%5D=b&a%5B1%5D=c&a%5B2%5D=d',
  103. 'default => indices'
  104. );
  105. st.end();
  106. });
  107. t.test('omits nulls when asked', function (st) {
  108. st.equal(qs.stringify({ a: 'b', c: null }, { skipNulls: true }), 'a=b');
  109. st.end();
  110. });
  111. t.test('omits nested nulls when asked', function (st) {
  112. st.equal(qs.stringify({ a: { b: 'c', d: null } }, { skipNulls: true }), 'a%5Bb%5D=c');
  113. st.end();
  114. });
  115. t.test('omits array indices when asked', function (st) {
  116. st.equal(qs.stringify({ a: ['b', 'c', 'd'] }, { indices: false }), 'a=b&a=c&a=d');
  117. st.end();
  118. });
  119. t.test('stringifies an array value with one item vs multiple items', function (st) {
  120. st.test('non-array item', function (s2t) {
  121. s2t.equal(qs.stringify({ a: 'c' }, { encodeValuesOnly: true, arrayFormat: 'indices' }), 'a=c');
  122. s2t.equal(qs.stringify({ a: 'c' }, { encodeValuesOnly: true, arrayFormat: 'brackets' }), 'a=c');
  123. s2t.equal(qs.stringify({ a: 'c' }, { encodeValuesOnly: true, arrayFormat: 'comma' }), 'a=c');
  124. s2t.equal(qs.stringify({ a: 'c' }, { encodeValuesOnly: true }), 'a=c');
  125. s2t.end();
  126. });
  127. st.test('array with a single item', function (s2t) {
  128. s2t.equal(qs.stringify({ a: ['c'] }, { encodeValuesOnly: true, arrayFormat: 'indices' }), 'a[0]=c');
  129. s2t.equal(qs.stringify({ a: ['c'] }, { encodeValuesOnly: true, arrayFormat: 'brackets' }), 'a[]=c');
  130. s2t.equal(qs.stringify({ a: ['c'] }, { encodeValuesOnly: true, arrayFormat: 'comma' }), 'a=c');
  131. s2t.equal(qs.stringify({ a: ['c'] }, { encodeValuesOnly: true, arrayFormat: 'comma', commaRoundTrip: true }), 'a[]=c'); // so it parses back as an array
  132. s2t.equal(qs.stringify({ a: ['c'] }, { encodeValuesOnly: true }), 'a[0]=c');
  133. s2t.end();
  134. });
  135. st.test('array with multiple items', function (s2t) {
  136. s2t.equal(qs.stringify({ a: ['c', 'd'] }, { encodeValuesOnly: true, arrayFormat: 'indices' }), 'a[0]=c&a[1]=d');
  137. s2t.equal(qs.stringify({ a: ['c', 'd'] }, { encodeValuesOnly: true, arrayFormat: 'brackets' }), 'a[]=c&a[]=d');
  138. s2t.equal(qs.stringify({ a: ['c', 'd'] }, { encodeValuesOnly: true, arrayFormat: 'comma' }), 'a=c,d');
  139. s2t.equal(qs.stringify({ a: ['c', 'd'] }, { encodeValuesOnly: true }), 'a[0]=c&a[1]=d');
  140. s2t.end();
  141. });
  142. st.end();
  143. });
  144. t.test('stringifies a nested array value', function (st) {
  145. st.equal(qs.stringify({ a: { b: ['c', 'd'] } }, { encodeValuesOnly: true, arrayFormat: 'indices' }), 'a[b][0]=c&a[b][1]=d');
  146. st.equal(qs.stringify({ a: { b: ['c', 'd'] } }, { encodeValuesOnly: true, arrayFormat: 'brackets' }), 'a[b][]=c&a[b][]=d');
  147. st.equal(qs.stringify({ a: { b: ['c', 'd'] } }, { encodeValuesOnly: true, arrayFormat: 'comma' }), 'a[b]=c,d');
  148. st.equal(qs.stringify({ a: { b: ['c', 'd'] } }, { encodeValuesOnly: true }), 'a[b][0]=c&a[b][1]=d');
  149. st.end();
  150. });
  151. t.test('stringifies a nested array value with dots notation', function (st) {
  152. st.equal(
  153. qs.stringify(
  154. { a: { b: ['c', 'd'] } },
  155. { allowDots: true, encodeValuesOnly: true, arrayFormat: 'indices' }
  156. ),
  157. 'a.b[0]=c&a.b[1]=d',
  158. 'indices: stringifies with dots + indices'
  159. );
  160. st.equal(
  161. qs.stringify(
  162. { a: { b: ['c', 'd'] } },
  163. { allowDots: true, encodeValuesOnly: true, arrayFormat: 'brackets' }
  164. ),
  165. 'a.b[]=c&a.b[]=d',
  166. 'brackets: stringifies with dots + brackets'
  167. );
  168. st.equal(
  169. qs.stringify(
  170. { a: { b: ['c', 'd'] } },
  171. { allowDots: true, encodeValuesOnly: true, arrayFormat: 'comma' }
  172. ),
  173. 'a.b=c,d',
  174. 'comma: stringifies with dots + comma'
  175. );
  176. st.equal(
  177. qs.stringify(
  178. { a: { b: ['c', 'd'] } },
  179. { allowDots: true, encodeValuesOnly: true }
  180. ),
  181. 'a.b[0]=c&a.b[1]=d',
  182. 'default: stringifies with dots + indices'
  183. );
  184. st.end();
  185. });
  186. t.test('stringifies an object inside an array', function (st) {
  187. st.equal(
  188. qs.stringify({ a: [{ b: 'c' }] }, { arrayFormat: 'indices' }),
  189. 'a%5B0%5D%5Bb%5D=c', // a[0][b]=c
  190. 'indices => brackets'
  191. );
  192. st.equal(
  193. qs.stringify({ a: [{ b: 'c' }] }, { arrayFormat: 'brackets' }),
  194. 'a%5B%5D%5Bb%5D=c', // a[][b]=c
  195. 'brackets => brackets'
  196. );
  197. st.equal(
  198. qs.stringify({ a: [{ b: 'c' }] }),
  199. 'a%5B0%5D%5Bb%5D=c',
  200. 'default => indices'
  201. );
  202. st.equal(
  203. qs.stringify({ a: [{ b: { c: [1] } }] }, { arrayFormat: 'indices' }),
  204. 'a%5B0%5D%5Bb%5D%5Bc%5D%5B0%5D=1',
  205. 'indices => indices'
  206. );
  207. st.equal(
  208. qs.stringify({ a: [{ b: { c: [1] } }] }, { arrayFormat: 'brackets' }),
  209. 'a%5B%5D%5Bb%5D%5Bc%5D%5B%5D=1',
  210. 'brackets => brackets'
  211. );
  212. st.equal(
  213. qs.stringify({ a: [{ b: { c: [1] } }] }),
  214. 'a%5B0%5D%5Bb%5D%5Bc%5D%5B0%5D=1',
  215. 'default => indices'
  216. );
  217. st.end();
  218. });
  219. t.test('stringifies an array with mixed objects and primitives', function (st) {
  220. st.equal(
  221. qs.stringify({ a: [{ b: 1 }, 2, 3] }, { encodeValuesOnly: true, arrayFormat: 'indices' }),
  222. 'a[0][b]=1&a[1]=2&a[2]=3',
  223. 'indices => indices'
  224. );
  225. st.equal(
  226. qs.stringify({ a: [{ b: 1 }, 2, 3] }, { encodeValuesOnly: true, arrayFormat: 'brackets' }),
  227. 'a[][b]=1&a[]=2&a[]=3',
  228. 'brackets => brackets'
  229. );
  230. st.equal(
  231. qs.stringify({ a: [{ b: 1 }, 2, 3] }, { encodeValuesOnly: true, arrayFormat: 'comma' }),
  232. '???',
  233. 'brackets => brackets',
  234. { skip: 'TODO: figure out what this should do' }
  235. );
  236. st.equal(
  237. qs.stringify({ a: [{ b: 1 }, 2, 3] }, { encodeValuesOnly: true }),
  238. 'a[0][b]=1&a[1]=2&a[2]=3',
  239. 'default => indices'
  240. );
  241. st.end();
  242. });
  243. t.test('stringifies an object inside an array with dots notation', function (st) {
  244. st.equal(
  245. qs.stringify(
  246. { a: [{ b: 'c' }] },
  247. { allowDots: true, encode: false, arrayFormat: 'indices' }
  248. ),
  249. 'a[0].b=c',
  250. 'indices => indices'
  251. );
  252. st.equal(
  253. qs.stringify(
  254. { a: [{ b: 'c' }] },
  255. { allowDots: true, encode: false, arrayFormat: 'brackets' }
  256. ),
  257. 'a[].b=c',
  258. 'brackets => brackets'
  259. );
  260. st.equal(
  261. qs.stringify(
  262. { a: [{ b: 'c' }] },
  263. { allowDots: true, encode: false }
  264. ),
  265. 'a[0].b=c',
  266. 'default => indices'
  267. );
  268. st.equal(
  269. qs.stringify(
  270. { a: [{ b: { c: [1] } }] },
  271. { allowDots: true, encode: false, arrayFormat: 'indices' }
  272. ),
  273. 'a[0].b.c[0]=1',
  274. 'indices => indices'
  275. );
  276. st.equal(
  277. qs.stringify(
  278. { a: [{ b: { c: [1] } }] },
  279. { allowDots: true, encode: false, arrayFormat: 'brackets' }
  280. ),
  281. 'a[].b.c[]=1',
  282. 'brackets => brackets'
  283. );
  284. st.equal(
  285. qs.stringify(
  286. { a: [{ b: { c: [1] } }] },
  287. { allowDots: true, encode: false }
  288. ),
  289. 'a[0].b.c[0]=1',
  290. 'default => indices'
  291. );
  292. st.end();
  293. });
  294. t.test('does not omit object keys when indices = false', function (st) {
  295. st.equal(qs.stringify({ a: [{ b: 'c' }] }, { indices: false }), 'a%5Bb%5D=c');
  296. st.end();
  297. });
  298. t.test('uses indices notation for arrays when indices=true', function (st) {
  299. st.equal(qs.stringify({ a: ['b', 'c'] }, { indices: true }), 'a%5B0%5D=b&a%5B1%5D=c');
  300. st.end();
  301. });
  302. t.test('uses indices notation for arrays when no arrayFormat is specified', function (st) {
  303. st.equal(qs.stringify({ a: ['b', 'c'] }), 'a%5B0%5D=b&a%5B1%5D=c');
  304. st.end();
  305. });
  306. t.test('uses indices notation for arrays when no arrayFormat=indices', function (st) {
  307. st.equal(qs.stringify({ a: ['b', 'c'] }, { arrayFormat: 'indices' }), 'a%5B0%5D=b&a%5B1%5D=c');
  308. st.end();
  309. });
  310. t.test('uses repeat notation for arrays when no arrayFormat=repeat', function (st) {
  311. st.equal(qs.stringify({ a: ['b', 'c'] }, { arrayFormat: 'repeat' }), 'a=b&a=c');
  312. st.end();
  313. });
  314. t.test('uses brackets notation for arrays when no arrayFormat=brackets', function (st) {
  315. st.equal(qs.stringify({ a: ['b', 'c'] }, { arrayFormat: 'brackets' }), 'a%5B%5D=b&a%5B%5D=c');
  316. st.end();
  317. });
  318. t.test('stringifies a complicated object', function (st) {
  319. st.equal(qs.stringify({ a: { b: 'c', d: 'e' } }), 'a%5Bb%5D=c&a%5Bd%5D=e');
  320. st.end();
  321. });
  322. t.test('stringifies an empty value', function (st) {
  323. st.equal(qs.stringify({ a: '' }), 'a=');
  324. st.equal(qs.stringify({ a: null }, { strictNullHandling: true }), 'a');
  325. st.equal(qs.stringify({ a: '', b: '' }), 'a=&b=');
  326. st.equal(qs.stringify({ a: null, b: '' }, { strictNullHandling: true }), 'a&b=');
  327. st.equal(qs.stringify({ a: { b: '' } }), 'a%5Bb%5D=');
  328. st.equal(qs.stringify({ a: { b: null } }, { strictNullHandling: true }), 'a%5Bb%5D');
  329. st.equal(qs.stringify({ a: { b: null } }, { strictNullHandling: false }), 'a%5Bb%5D=');
  330. st.end();
  331. });
  332. t.test('stringifies an empty array in different arrayFormat', function (st) {
  333. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false }), 'b[0]=&c=c');
  334. // arrayFormat default
  335. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'indices' }), 'b[0]=&c=c');
  336. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'brackets' }), 'b[]=&c=c');
  337. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'repeat' }), 'b=&c=c');
  338. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'comma' }), 'b=&c=c');
  339. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'comma', commaRoundTrip: true }), 'b[]=&c=c');
  340. // with strictNullHandling
  341. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'indices', strictNullHandling: true }), 'b[0]&c=c');
  342. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'brackets', strictNullHandling: true }), 'b[]&c=c');
  343. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'repeat', strictNullHandling: true }), 'b&c=c');
  344. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'comma', strictNullHandling: true }), 'b&c=c');
  345. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'comma', strictNullHandling: true, commaRoundTrip: true }), 'b[]&c=c');
  346. // with skipNulls
  347. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'indices', skipNulls: true }), 'c=c');
  348. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'brackets', skipNulls: true }), 'c=c');
  349. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'repeat', skipNulls: true }), 'c=c');
  350. st.equal(qs.stringify({ a: [], b: [null], c: 'c' }, { encode: false, arrayFormat: 'comma', skipNulls: true }), 'c=c');
  351. st.end();
  352. });
  353. t.test('stringifies a null object', { skip: !Object.create }, function (st) {
  354. var obj = Object.create(null);
  355. obj.a = 'b';
  356. st.equal(qs.stringify(obj), 'a=b');
  357. st.end();
  358. });
  359. t.test('returns an empty string for invalid input', function (st) {
  360. st.equal(qs.stringify(undefined), '');
  361. st.equal(qs.stringify(false), '');
  362. st.equal(qs.stringify(null), '');
  363. st.equal(qs.stringify(''), '');
  364. st.end();
  365. });
  366. t.test('stringifies an object with a null object as a child', { skip: !Object.create }, function (st) {
  367. var obj = { a: Object.create(null) };
  368. obj.a.b = 'c';
  369. st.equal(qs.stringify(obj), 'a%5Bb%5D=c');
  370. st.end();
  371. });
  372. t.test('drops keys with a value of undefined', function (st) {
  373. st.equal(qs.stringify({ a: undefined }), '');
  374. st.equal(qs.stringify({ a: { b: undefined, c: null } }, { strictNullHandling: true }), 'a%5Bc%5D');
  375. st.equal(qs.stringify({ a: { b: undefined, c: null } }, { strictNullHandling: false }), 'a%5Bc%5D=');
  376. st.equal(qs.stringify({ a: { b: undefined, c: '' } }), 'a%5Bc%5D=');
  377. st.end();
  378. });
  379. t.test('url encodes values', function (st) {
  380. st.equal(qs.stringify({ a: 'b c' }), 'a=b%20c');
  381. st.end();
  382. });
  383. t.test('stringifies a date', function (st) {
  384. var now = new Date();
  385. var str = 'a=' + encodeURIComponent(now.toISOString());
  386. st.equal(qs.stringify({ a: now }), str);
  387. st.end();
  388. });
  389. t.test('stringifies the weird object from qs', function (st) {
  390. 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');
  391. st.end();
  392. });
  393. t.test('skips properties that are part of the object prototype', function (st) {
  394. Object.prototype.crash = 'test';
  395. st.equal(qs.stringify({ a: 'b' }), 'a=b');
  396. st.equal(qs.stringify({ a: { b: 'c' } }), 'a%5Bb%5D=c');
  397. delete Object.prototype.crash;
  398. st.end();
  399. });
  400. t.test('stringifies boolean values', function (st) {
  401. st.equal(qs.stringify({ a: true }), 'a=true');
  402. st.equal(qs.stringify({ a: { b: true } }), 'a%5Bb%5D=true');
  403. st.equal(qs.stringify({ b: false }), 'b=false');
  404. st.equal(qs.stringify({ b: { c: false } }), 'b%5Bc%5D=false');
  405. st.end();
  406. });
  407. t.test('stringifies buffer values', function (st) {
  408. st.equal(qs.stringify({ a: SaferBuffer.from('test') }), 'a=test');
  409. st.equal(qs.stringify({ a: { b: SaferBuffer.from('test') } }), 'a%5Bb%5D=test');
  410. st.end();
  411. });
  412. t.test('stringifies an object using an alternative delimiter', function (st) {
  413. st.equal(qs.stringify({ a: 'b', c: 'd' }, { delimiter: ';' }), 'a=b;c=d');
  414. st.end();
  415. });
  416. t.test('does not blow up when Buffer global is missing', function (st) {
  417. var tempBuffer = global.Buffer;
  418. delete global.Buffer;
  419. var result = qs.stringify({ a: 'b', c: 'd' });
  420. global.Buffer = tempBuffer;
  421. st.equal(result, 'a=b&c=d');
  422. st.end();
  423. });
  424. t.test('does not crash when parsing circular references', function (st) {
  425. var a = {};
  426. a.b = a;
  427. st['throws'](
  428. function () { qs.stringify({ 'foo[bar]': 'baz', 'foo[baz]': a }); },
  429. /RangeError: Cyclic object value/,
  430. 'cyclic values throw'
  431. );
  432. var circular = {
  433. a: 'value'
  434. };
  435. circular.a = circular;
  436. st['throws'](
  437. function () { qs.stringify(circular); },
  438. /RangeError: Cyclic object value/,
  439. 'cyclic values throw'
  440. );
  441. var arr = ['a'];
  442. st.doesNotThrow(
  443. function () { qs.stringify({ x: arr, y: arr }); },
  444. 'non-cyclic values do not throw'
  445. );
  446. st.end();
  447. });
  448. t.test('non-circular duplicated references can still work', function (st) {
  449. var hourOfDay = {
  450. 'function': 'hour_of_day'
  451. };
  452. var p1 = {
  453. 'function': 'gte',
  454. arguments: [hourOfDay, 0]
  455. };
  456. var p2 = {
  457. 'function': 'lte',
  458. arguments: [hourOfDay, 23]
  459. };
  460. st.equal(
  461. qs.stringify({ filters: { $and: [p1, p2] } }, { encodeValuesOnly: true }),
  462. 'filters[$and][0][function]=gte&filters[$and][0][arguments][0][function]=hour_of_day&filters[$and][0][arguments][1]=0&filters[$and][1][function]=lte&filters[$and][1][arguments][0][function]=hour_of_day&filters[$and][1][arguments][1]=23'
  463. );
  464. st.end();
  465. });
  466. t.test('selects properties when filter=array', function (st) {
  467. st.equal(qs.stringify({ a: 'b' }, { filter: ['a'] }), 'a=b');
  468. st.equal(qs.stringify({ a: 1 }, { filter: [] }), '');
  469. st.equal(
  470. qs.stringify(
  471. { a: { b: [1, 2, 3, 4], c: 'd' }, c: 'f' },
  472. { filter: ['a', 'b', 0, 2], arrayFormat: 'indices' }
  473. ),
  474. 'a%5Bb%5D%5B0%5D=1&a%5Bb%5D%5B2%5D=3',
  475. 'indices => indices'
  476. );
  477. st.equal(
  478. qs.stringify(
  479. { a: { b: [1, 2, 3, 4], c: 'd' }, c: 'f' },
  480. { filter: ['a', 'b', 0, 2], arrayFormat: 'brackets' }
  481. ),
  482. 'a%5Bb%5D%5B%5D=1&a%5Bb%5D%5B%5D=3',
  483. 'brackets => brackets'
  484. );
  485. st.equal(
  486. qs.stringify(
  487. { a: { b: [1, 2, 3, 4], c: 'd' }, c: 'f' },
  488. { filter: ['a', 'b', 0, 2] }
  489. ),
  490. 'a%5Bb%5D%5B0%5D=1&a%5Bb%5D%5B2%5D=3',
  491. 'default => indices'
  492. );
  493. st.end();
  494. });
  495. t.test('supports custom representations when filter=function', function (st) {
  496. var calls = 0;
  497. var obj = { a: 'b', c: 'd', e: { f: new Date(1257894000000) } };
  498. var filterFunc = function (prefix, value) {
  499. calls += 1;
  500. if (calls === 1) {
  501. st.equal(prefix, '', 'prefix is empty');
  502. st.equal(value, obj);
  503. } else if (prefix === 'c') {
  504. return void 0;
  505. } else if (value instanceof Date) {
  506. st.equal(prefix, 'e[f]');
  507. return value.getTime();
  508. }
  509. return value;
  510. };
  511. st.equal(qs.stringify(obj, { filter: filterFunc }), 'a=b&e%5Bf%5D=1257894000000');
  512. st.equal(calls, 5);
  513. st.end();
  514. });
  515. t.test('can disable uri encoding', function (st) {
  516. st.equal(qs.stringify({ a: 'b' }, { encode: false }), 'a=b');
  517. st.equal(qs.stringify({ a: { b: 'c' } }, { encode: false }), 'a[b]=c');
  518. st.equal(qs.stringify({ a: 'b', c: null }, { strictNullHandling: true, encode: false }), 'a=b&c');
  519. st.end();
  520. });
  521. t.test('can sort the keys', function (st) {
  522. var sort = function (a, b) {
  523. return a.localeCompare(b);
  524. };
  525. st.equal(qs.stringify({ a: 'c', z: 'y', b: 'f' }, { sort: sort }), 'a=c&b=f&z=y');
  526. 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');
  527. st.end();
  528. });
  529. t.test('can sort the keys at depth 3 or more too', function (st) {
  530. var sort = function (a, b) {
  531. return a.localeCompare(b);
  532. };
  533. st.equal(
  534. qs.stringify(
  535. { a: 'a', z: { zj: { zjb: 'zjb', zja: 'zja' }, zi: { zib: 'zib', zia: 'zia' } }, b: 'b' },
  536. { sort: sort, encode: false }
  537. ),
  538. 'a=a&b=b&z[zi][zia]=zia&z[zi][zib]=zib&z[zj][zja]=zja&z[zj][zjb]=zjb'
  539. );
  540. st.equal(
  541. qs.stringify(
  542. { a: 'a', z: { zj: { zjb: 'zjb', zja: 'zja' }, zi: { zib: 'zib', zia: 'zia' } }, b: 'b' },
  543. { sort: null, encode: false }
  544. ),
  545. 'a=a&z[zj][zjb]=zjb&z[zj][zja]=zja&z[zi][zib]=zib&z[zi][zia]=zia&b=b'
  546. );
  547. st.end();
  548. });
  549. t.test('can stringify with custom encoding', function (st) {
  550. st.equal(qs.stringify({ 県: '大阪府', '': '' }, {
  551. encoder: function (str) {
  552. if (str.length === 0) {
  553. return '';
  554. }
  555. var buf = iconv.encode(str, 'shiftjis');
  556. var result = [];
  557. for (var i = 0; i < buf.length; ++i) {
  558. result.push(buf.readUInt8(i).toString(16));
  559. }
  560. return '%' + result.join('%');
  561. }
  562. }), '%8c%a7=%91%e5%8d%e3%95%7b&=');
  563. st.end();
  564. });
  565. t.test('receives the default encoder as a second argument', function (st) {
  566. st.plan(2);
  567. qs.stringify({ a: 1 }, {
  568. encoder: function (str, defaultEncoder) {
  569. st.equal(defaultEncoder, utils.encode);
  570. }
  571. });
  572. st.end();
  573. });
  574. t.test('throws error with wrong encoder', function (st) {
  575. st['throws'](function () {
  576. qs.stringify({}, { encoder: 'string' });
  577. }, new TypeError('Encoder has to be a function.'));
  578. st.end();
  579. });
  580. t.test('can use custom encoder for a buffer object', { skip: typeof Buffer === 'undefined' }, function (st) {
  581. st.equal(qs.stringify({ a: SaferBuffer.from([1]) }, {
  582. encoder: function (buffer) {
  583. if (typeof buffer === 'string') {
  584. return buffer;
  585. }
  586. return String.fromCharCode(buffer.readUInt8(0) + 97);
  587. }
  588. }), 'a=b');
  589. st.equal(qs.stringify({ a: SaferBuffer.from('a b') }, {
  590. encoder: function (buffer) {
  591. return buffer;
  592. }
  593. }), 'a=a b');
  594. st.end();
  595. });
  596. t.test('serializeDate option', function (st) {
  597. var date = new Date();
  598. st.equal(
  599. qs.stringify({ a: date }),
  600. 'a=' + date.toISOString().replace(/:/g, '%3A'),
  601. 'default is toISOString'
  602. );
  603. var mutatedDate = new Date();
  604. mutatedDate.toISOString = function () {
  605. throw new SyntaxError();
  606. };
  607. st['throws'](function () {
  608. mutatedDate.toISOString();
  609. }, SyntaxError);
  610. st.equal(
  611. qs.stringify({ a: mutatedDate }),
  612. 'a=' + Date.prototype.toISOString.call(mutatedDate).replace(/:/g, '%3A'),
  613. 'toISOString works even when method is not locally present'
  614. );
  615. var specificDate = new Date(6);
  616. st.equal(
  617. qs.stringify(
  618. { a: specificDate },
  619. { serializeDate: function (d) { return d.getTime() * 7; } }
  620. ),
  621. 'a=42',
  622. 'custom serializeDate function called'
  623. );
  624. st.equal(
  625. qs.stringify(
  626. { a: [date] },
  627. {
  628. serializeDate: function (d) { return d.getTime(); },
  629. arrayFormat: 'comma'
  630. }
  631. ),
  632. 'a=' + date.getTime(),
  633. 'works with arrayFormat comma'
  634. );
  635. st.equal(
  636. qs.stringify(
  637. { a: [date] },
  638. {
  639. serializeDate: function (d) { return d.getTime(); },
  640. arrayFormat: 'comma',
  641. commaRoundTrip: true
  642. }
  643. ),
  644. 'a%5B%5D=' + date.getTime(),
  645. 'works with arrayFormat comma'
  646. );
  647. st.end();
  648. });
  649. t.test('RFC 1738 serialization', function (st) {
  650. st.equal(qs.stringify({ a: 'b c' }, { format: qs.formats.RFC1738 }), 'a=b+c');
  651. st.equal(qs.stringify({ 'a b': 'c d' }, { format: qs.formats.RFC1738 }), 'a+b=c+d');
  652. st.equal(qs.stringify({ 'a b': SaferBuffer.from('a b') }, { format: qs.formats.RFC1738 }), 'a+b=a+b');
  653. st.equal(qs.stringify({ 'foo(ref)': 'bar' }, { format: qs.formats.RFC1738 }), 'foo(ref)=bar');
  654. st.end();
  655. });
  656. t.test('RFC 3986 spaces serialization', function (st) {
  657. st.equal(qs.stringify({ a: 'b c' }, { format: qs.formats.RFC3986 }), 'a=b%20c');
  658. st.equal(qs.stringify({ 'a b': 'c d' }, { format: qs.formats.RFC3986 }), 'a%20b=c%20d');
  659. st.equal(qs.stringify({ 'a b': SaferBuffer.from('a b') }, { format: qs.formats.RFC3986 }), 'a%20b=a%20b');
  660. st.end();
  661. });
  662. t.test('Backward compatibility to RFC 3986', function (st) {
  663. st.equal(qs.stringify({ a: 'b c' }), 'a=b%20c');
  664. st.equal(qs.stringify({ 'a b': SaferBuffer.from('a b') }), 'a%20b=a%20b');
  665. st.end();
  666. });
  667. t.test('Edge cases and unknown formats', function (st) {
  668. ['UFO1234', false, 1234, null, {}, []].forEach(function (format) {
  669. st['throws'](
  670. function () {
  671. qs.stringify({ a: 'b c' }, { format: format });
  672. },
  673. new TypeError('Unknown format option provided.')
  674. );
  675. });
  676. st.end();
  677. });
  678. t.test('encodeValuesOnly', function (st) {
  679. st.equal(
  680. qs.stringify(
  681. { a: 'b', c: ['d', 'e=f'], f: [['g'], ['h']] },
  682. { encodeValuesOnly: true }
  683. ),
  684. 'a=b&c[0]=d&c[1]=e%3Df&f[0][0]=g&f[1][0]=h'
  685. );
  686. st.equal(
  687. qs.stringify(
  688. { a: 'b', c: ['d', 'e'], f: [['g'], ['h']] }
  689. ),
  690. 'a=b&c%5B0%5D=d&c%5B1%5D=e&f%5B0%5D%5B0%5D=g&f%5B1%5D%5B0%5D=h'
  691. );
  692. st.end();
  693. });
  694. t.test('encodeValuesOnly - strictNullHandling', function (st) {
  695. st.equal(
  696. qs.stringify(
  697. { a: { b: null } },
  698. { encodeValuesOnly: true, strictNullHandling: true }
  699. ),
  700. 'a[b]'
  701. );
  702. st.end();
  703. });
  704. t.test('throws if an invalid charset is specified', function (st) {
  705. st['throws'](function () {
  706. qs.stringify({ a: 'b' }, { charset: 'foobar' });
  707. }, new TypeError('The charset option must be either utf-8, iso-8859-1, or undefined'));
  708. st.end();
  709. });
  710. t.test('respects a charset of iso-8859-1', function (st) {
  711. st.equal(qs.stringify({ æ: 'æ' }, { charset: 'iso-8859-1' }), '%E6=%E6');
  712. st.end();
  713. });
  714. t.test('encodes unrepresentable chars as numeric entities in iso-8859-1 mode', function (st) {
  715. st.equal(qs.stringify({ a: '☺' }, { charset: 'iso-8859-1' }), 'a=%26%239786%3B');
  716. st.end();
  717. });
  718. t.test('respects an explicit charset of utf-8 (the default)', function (st) {
  719. st.equal(qs.stringify({ a: 'æ' }, { charset: 'utf-8' }), 'a=%C3%A6');
  720. st.end();
  721. });
  722. t.test('adds the right sentinel when instructed to and the charset is utf-8', function (st) {
  723. st.equal(qs.stringify({ a: 'æ' }, { charsetSentinel: true, charset: 'utf-8' }), 'utf8=%E2%9C%93&a=%C3%A6');
  724. st.end();
  725. });
  726. t.test('adds the right sentinel when instructed to and the charset is iso-8859-1', function (st) {
  727. st.equal(qs.stringify({ a: 'æ' }, { charsetSentinel: true, charset: 'iso-8859-1' }), 'utf8=%26%2310003%3B&a=%E6');
  728. st.end();
  729. });
  730. t.test('does not mutate the options argument', function (st) {
  731. var options = {};
  732. qs.stringify({}, options);
  733. st.deepEqual(options, {});
  734. st.end();
  735. });
  736. t.test('strictNullHandling works with custom filter', function (st) {
  737. var filter = function (prefix, value) {
  738. return value;
  739. };
  740. var options = { strictNullHandling: true, filter: filter };
  741. st.equal(qs.stringify({ key: null }, options), 'key');
  742. st.end();
  743. });
  744. t.test('strictNullHandling works with null serializeDate', function (st) {
  745. var serializeDate = function () {
  746. return null;
  747. };
  748. var options = { strictNullHandling: true, serializeDate: serializeDate };
  749. var date = new Date();
  750. st.equal(qs.stringify({ key: date }, options), 'key');
  751. st.end();
  752. });
  753. t.test('allows for encoding keys and values differently', function (st) {
  754. var encoder = function (str, defaultEncoder, charset, type) {
  755. if (type === 'key') {
  756. return defaultEncoder(str, defaultEncoder, charset, type).toLowerCase();
  757. }
  758. if (type === 'value') {
  759. return defaultEncoder(str, defaultEncoder, charset, type).toUpperCase();
  760. }
  761. throw 'this should never happen! type: ' + type;
  762. };
  763. st.deepEqual(qs.stringify({ KeY: 'vAlUe' }, { encoder: encoder }), 'key=VALUE');
  764. st.end();
  765. });
  766. t.test('objects inside arrays', function (st) {
  767. var obj = { a: { b: { c: 'd', e: 'f' } } };
  768. var withArray = { a: { b: [{ c: 'd', e: 'f' }] } };
  769. st.equal(qs.stringify(obj, { encode: false }), 'a[b][c]=d&a[b][e]=f', 'no array, no arrayFormat');
  770. st.equal(qs.stringify(obj, { encode: false, arrayFormat: 'bracket' }), 'a[b][c]=d&a[b][e]=f', 'no array, bracket');
  771. st.equal(qs.stringify(obj, { encode: false, arrayFormat: 'indices' }), 'a[b][c]=d&a[b][e]=f', 'no array, indices');
  772. st.equal(qs.stringify(obj, { encode: false, arrayFormat: 'comma' }), 'a[b][c]=d&a[b][e]=f', 'no array, comma');
  773. st.equal(qs.stringify(withArray, { encode: false }), 'a[b][0][c]=d&a[b][0][e]=f', 'array, no arrayFormat');
  774. st.equal(qs.stringify(withArray, { encode: false, arrayFormat: 'bracket' }), 'a[b][0][c]=d&a[b][0][e]=f', 'array, bracket');
  775. st.equal(qs.stringify(withArray, { encode: false, arrayFormat: 'indices' }), 'a[b][0][c]=d&a[b][0][e]=f', 'array, indices');
  776. st.equal(
  777. qs.stringify(withArray, { encode: false, arrayFormat: 'comma' }),
  778. '???',
  779. 'array, comma',
  780. { skip: 'TODO: figure out what this should do' }
  781. );
  782. st.end();
  783. });
  784. t.test('stringifies sparse arrays', function (st) {
  785. /* eslint no-sparse-arrays: 0 */
  786. st.equal(qs.stringify({ a: [, '2', , , '1'] }, { encodeValuesOnly: true }), 'a[1]=2&a[4]=1');
  787. st.equal(qs.stringify({ a: [, { b: [, , { c: '1' }] }] }, { encodeValuesOnly: true }), 'a[1][b][2][c]=1');
  788. st.equal(qs.stringify({ a: [, [, , [, , , { c: '1' }]]] }, { encodeValuesOnly: true }), 'a[1][2][3][c]=1');
  789. st.equal(qs.stringify({ a: [, [, , [, , , { c: [, '1'] }]]] }, { encodeValuesOnly: true }), 'a[1][2][3][c][1]=1');
  790. st.end();
  791. });
  792. t.end();
  793. });