Add decode option to .parse() (sindresorhus#124)

index.js

@@ -96,6 +96,14 @@ function encode(value, options) {
 	return value;
 }
 
+function decode(value, options) {
+	if (options.decode) {
+		return decodeComponent(value);
+	}
+
+	return value;
+}
+
 function keysSorter(input) {
 	if (Array.isArray(input)) {
 		return input.sort();
@@ -119,7 +127,7 @@ function extract(input) {
 }
 
 function parse(input, options) {
-	options = Object.assign({arrayFormat: 'none'}, options);
+	options = Object.assign({decode: true, arrayFormat: 'none'}, options);
 
 	const formatter = parserForArrayFormat(options);
 
@@ -141,9 +149,9 @@ function parse(input, options) {
 
 		// Missing `=` should be `null`:
 		// http://w3.org/TR/2012/WD-url-20120524/#collect-url-parameters
-		value = value === undefined ? null : decodeComponent(value);
+		value = value === undefined ? null : decode(value, options);
 
-		formatter(decodeComponent(key), value, ret);
+		formatter(decode(key, options), value, ret);
 	}
 
 	return Object.keys(ret).sort().reduce((result, key) => {

readme.md

@@ -62,7 +62,12 @@ Parse a query string into an object. Leading `?` or `#` are ignored, so you can
 
 The returned object is created with [`Object.create(null)`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/create) and thus does not have a `prototype`.
 
-URI components are decoded with [`decode-uri-component`](https://github.com/SamVerschueren/decode-uri-component).
+#### decode
+
+Type: `boolean`<br>
+Default: `true`
+
+Decode the keys and values. URI components are decoded with [`decode-uri-component`](https://github.com/SamVerschueren/decode-uri-component).
 
 #### arrayFormat
 

test/parse.js

@@ -179,3 +179,7 @@ test('decode keys and values', t => {
 	t.deepEqual(m.parse('st%C3%A5le=foo'), {ståle: 'foo'});
 	t.deepEqual(m.parse('foo=%7B%ab%%7C%de%%7D+%%7Bst%C3%A5le%7D%'), {foo: '{%ab%|%de%} %{ståle}%'});
 });
+
+test('disable decoding of keys and values', t => {
+	t.deepEqual(m.parse('tags=postal%20office,burger%2C%20fries%20and%20coke', {decode: false}), {tags: 'postal%20office,burger%2C%20fries%20and%20coke'});
+});