1 | 'use strict';
|
---|
2 |
|
---|
3 | var has = Object.prototype.hasOwnProperty
|
---|
4 | , undef;
|
---|
5 |
|
---|
6 | /**
|
---|
7 | * Decode a URI encoded string.
|
---|
8 | *
|
---|
9 | * @param {String} input The URI encoded string.
|
---|
10 | * @returns {String|Null} The decoded string.
|
---|
11 | * @api private
|
---|
12 | */
|
---|
13 | function decode(input) {
|
---|
14 | try {
|
---|
15 | return decodeURIComponent(input.replace(/\+/g, ' '));
|
---|
16 | } catch (e) {
|
---|
17 | return null;
|
---|
18 | }
|
---|
19 | }
|
---|
20 |
|
---|
21 | /**
|
---|
22 | * Attempts to encode a given input.
|
---|
23 | *
|
---|
24 | * @param {String} input The string that needs to be encoded.
|
---|
25 | * @returns {String|Null} The encoded string.
|
---|
26 | * @api private
|
---|
27 | */
|
---|
28 | function encode(input) {
|
---|
29 | try {
|
---|
30 | return encodeURIComponent(input);
|
---|
31 | } catch (e) {
|
---|
32 | return null;
|
---|
33 | }
|
---|
34 | }
|
---|
35 |
|
---|
36 | /**
|
---|
37 | * Simple query string parser.
|
---|
38 | *
|
---|
39 | * @param {String} query The query string that needs to be parsed.
|
---|
40 | * @returns {Object}
|
---|
41 | * @api public
|
---|
42 | */
|
---|
43 | function querystring(query) {
|
---|
44 | var parser = /([^=?#&]+)=?([^&]*)/g
|
---|
45 | , result = {}
|
---|
46 | , part;
|
---|
47 |
|
---|
48 | while (part = parser.exec(query)) {
|
---|
49 | var key = decode(part[1])
|
---|
50 | , value = decode(part[2]);
|
---|
51 |
|
---|
52 | //
|
---|
53 | // Prevent overriding of existing properties. This ensures that build-in
|
---|
54 | // methods like `toString` or __proto__ are not overriden by malicious
|
---|
55 | // querystrings.
|
---|
56 | //
|
---|
57 | // In the case if failed decoding, we want to omit the key/value pairs
|
---|
58 | // from the result.
|
---|
59 | //
|
---|
60 | if (key === null || value === null || key in result) continue;
|
---|
61 | result[key] = value;
|
---|
62 | }
|
---|
63 |
|
---|
64 | return result;
|
---|
65 | }
|
---|
66 |
|
---|
67 | /**
|
---|
68 | * Transform a query string to an object.
|
---|
69 | *
|
---|
70 | * @param {Object} obj Object that should be transformed.
|
---|
71 | * @param {String} prefix Optional prefix.
|
---|
72 | * @returns {String}
|
---|
73 | * @api public
|
---|
74 | */
|
---|
75 | function querystringify(obj, prefix) {
|
---|
76 | prefix = prefix || '';
|
---|
77 |
|
---|
78 | var pairs = []
|
---|
79 | , value
|
---|
80 | , key;
|
---|
81 |
|
---|
82 | //
|
---|
83 | // Optionally prefix with a '?' if needed
|
---|
84 | //
|
---|
85 | if ('string' !== typeof prefix) prefix = '?';
|
---|
86 |
|
---|
87 | for (key in obj) {
|
---|
88 | if (has.call(obj, key)) {
|
---|
89 | value = obj[key];
|
---|
90 |
|
---|
91 | //
|
---|
92 | // Edge cases where we actually want to encode the value to an empty
|
---|
93 | // string instead of the stringified value.
|
---|
94 | //
|
---|
95 | if (!value && (value === null || value === undef || isNaN(value))) {
|
---|
96 | value = '';
|
---|
97 | }
|
---|
98 |
|
---|
99 | key = encode(key);
|
---|
100 | value = encode(value);
|
---|
101 |
|
---|
102 | //
|
---|
103 | // If we failed to encode the strings, we should bail out as we don't
|
---|
104 | // want to add invalid strings to the query.
|
---|
105 | //
|
---|
106 | if (key === null || value === null) continue;
|
---|
107 | pairs.push(key +'='+ value);
|
---|
108 | }
|
---|
109 | }
|
---|
110 |
|
---|
111 | return pairs.length ? prefix + pairs.join('&') : '';
|
---|
112 | }
|
---|
113 |
|
---|
114 | //
|
---|
115 | // Expose the module.
|
---|
116 | //
|
---|
117 | exports.stringify = querystringify;
|
---|
118 | exports.parse = querystring;
|
---|