query-string 9.1.1 → 9.2.0

package/base.d.ts

@@ -178,13 +178,13 @@ export type ParseOptions = {
 	readonly parseFragmentIdentifier?: boolean;
 
 	/**
-	Specify a pre-defined schema to be used when parsing values. The types specified will take precedence over options such as: `parseNumber`, `parseBooleans`, and `arrayFormat`.
+	Specifies a schema for parsing query values with explicit type declarations. When defined, the types provided here take precedence over general parsing options such as `parseNumbers`, `parseBooleans`, and `arrayFormat`.
 
-	Use this feature to override the type of a value. This can be useful when the type is ambiguous such as a phone number (see example 1 and 2).
+	Use this option to explicitly define the type of a specific parameter—particularly useful in cases where the type might otherwise be ambiguous (e.g., phone numbers or IDs).
 
-	It is possible to provide a custom function as the parameter type. The parameter's value will equal the function's return value (see example 4).
+	You can also provide a custom function to transform the value. The function will receive the raw string and should return the desired parsed result (see Example 4).
 
-	NOTE: Array types (`string[]` and `number[]`) will have no effect if `arrayFormat` is set to `none` (see example 5).
+	NOTE: Array types (`string[]`, `number[]`) are ignored if `arrayFormat` is set to `'none'`. (See Example 5.)
 
 	@default {}
 
@@ -217,7 +217,7 @@ export type ParseOptions = {
 	```
 
 	@example
-	Parse `age` as a number, even when `parseNumber` is false:
+	Force `age` to be parsed as a number even when `parseNumbers` is false:
 	```
 	import queryString from 'query-string';
 
@@ -226,11 +226,11 @@ export type ParseOptions = {
 			age: 'number',
 		}
 	});
-	//=> {age: 20, id: '01234', zipcode: '90210 }
+	//=> {age: 20, id: '01234', zipcode: '90210'}
 	```
 
 	@example
-	Parse `age` using a custom value parser:
+	Use a custom parser function to transform the value of `age`:
 	```
 	import queryString from 'query-string';
 
@@ -239,11 +239,11 @@ export type ParseOptions = {
 			age: (value) => value * 2,
 		}
 	});
-	//=> {age: 40, id: '01234', zipcode: '90210 }
+	//=> {age: 40, id: '01234', zipcode: '90210'}
 	```
 
 	@example
-	Array types will have no effect when `arrayFormat` is set to `none`
+	Array types are ignored when `arrayFormat` is set to `'none'`:
 	```
 	queryString.parse('ids=001%2C002%2C003&foods=apple%2Corange%2Cmango', {
 		arrayFormat: 'none',
@@ -256,7 +256,7 @@ export type ParseOptions = {
 	```
 
 	@example
-	Parse a query utilizing all types:
+	Parse a query using multiple type definitions:
 	```
 	import queryString from 'query-string';
 
@@ -273,10 +273,24 @@ export type ParseOptions = {
 	});
 	//=> {ids: '001,002,003', items: ['1', '2', '3'], price: '22.00', numbers: [1, 2, 3], double: 10, number: 20}
 	```
+
+	@example
+	Force `flagged` to be parsed as a boolean even when `parseBooleans` is false:
+	```
+	queryString.parse('?isAdmin=true&flagged=true&isOkay=0', {
+			parseBooleans: false,
+			types: {
+					flagged: 'boolean',
+					isOkay: 'boolean',
+			},
+	});
+	//=> {isAdmin: 'true', flagged: true, isOkay: false}
+	```
+	Note: The `'boolean'` type will also convert `'0'` and `'1'` string values to booleans.
 	*/
 	readonly types?: Record<
 	string,
-	'number' | 'string' | 'string[]' | 'number[]' | ((value: string) => unknown)
+	'boolean' | 'number' | 'string' | 'string[]' | 'number[]' | ((value: string) => unknown)
 	>;
 };
 

package/base.js

@@ -309,14 +309,30 @@ function parseValue(value, options, type) {
 		return type(value);
 	}
 
-	if (options.parseBooleans && value !== null && (value.toLowerCase() === 'true' || value.toLowerCase() === 'false')) {
+	if (type === 'boolean' && value !== null && (value.toLowerCase() === 'true' || value.toLowerCase() === 'false')) {
 		return value.toLowerCase() === 'true';
 	}
 
+	if (type === 'boolean' && value !== null && (value.toLowerCase() === '1' || value.toLowerCase() === '0')) {
+		return value.toLowerCase() === '1';
+	}
+
+	if (type === 'string[]' && options.arrayFormat !== 'none' && typeof value === 'string') {
+		return [value];
+	}
+
+	if (type === 'number[]' && options.arrayFormat !== 'none' && !Number.isNaN(Number(value)) && (typeof value === 'string' && value.trim() !== '')) {
+		return [Number(value)];
+	}
+
 	if (type === 'number' && !Number.isNaN(Number(value)) && (typeof value === 'string' && value.trim() !== '')) {
 		return Number(value);
 	}
 
+	if (options.parseBooleans && value !== null && (value.toLowerCase() === 'true' || value.toLowerCase() === 'false')) {
+		return value.toLowerCase() === 'true';
+	}
+
 	if (options.parseNumbers && !Number.isNaN(Number(value)) && (typeof value === 'string' && value.trim() !== '')) {
 		return Number(value);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "query-string",
-	"version": "9.1.1",
+	"version": "9.2.0",
 	"description": "Parse and stringify URL query strings",
 	"license": "MIT",
 	"repository": "sindresorhus/query-string",

package/readme.md

@@ -2,30 +2,6 @@
 
 > Parse and stringify URL [query strings](https://en.wikipedia.org/wiki/Query_string)
 
-<br>
-
----
-
-<div align="center">
-	<p>
-		<p>
-			<sup>
-				<a href="https://github.com/sponsors/sindresorhus">My open source work is supported by the community</a>
-			</sup>
-		</p>
-		<sup>Special thanks to:</sup>
-		<br>
-		<br>
-		<a href="https://standardresume.co/tech">
-			<img src="https://sindresorhus.com/assets/thanks/standard-resume-logo.svg" width="180"/>
-		</a>
-	</p>
-</div>
-
----
-
-<br>
-
 ## Install
 
 ```sh
@@ -217,15 +193,33 @@ Parse the value as a boolean type instead of string type if it's a boolean.
 Type: `object`\
 Default: `{}`
 
-Specify a pre-defined schema to be used when parsing values. The types specified will take precedence over options such as: `parseNumber`, `parseBooleans`, and `arrayFormat`.
 
-Use this feature to override the type of a value. This can be useful when the type is ambiguous such as a phone number.
+Specifies a schema for parsing query values with explicit type declarations. When defined, the types provided here take precedence over general parsing options such as `parseNumbers`, `parseBooleans`, and `arrayFormat`.
+
+Use this option to explicitly define the type of a specific parameter—particularly useful in cases where the type might otherwise be ambiguous (e.g., phone numbers or IDs).
+
+You can also provide a custom function to transform the value. The function will receive the raw string and should return the desired parsed result.
 
-It is possible to provide a custom function as the parameter type. The parameter's value will equal the function's return value.
 
 Supported Types:
 
-- `'string'`: Parse `phoneNumber` as a string (overriding the `parseNumber` option):
+
+- `'boolean'`: Parse `flagged` as a boolean (overriding the `parseBooleans` option):
+
+```js
+queryString.parse('?isAdmin=true&flagged=true&isOkay=0', {
+		parseBooleans: false,
+		types: {
+				flagged: 'boolean',
+				isOkay: 'boolean',
+		},
+});
+//=> {isAdmin: 'true', flagged: true, isOkay: false}
+```
+
+Note: The `'boolean'` type will also convert `'0'` and `'1'` string values to booleans.
+
+- `'string'`: Parse `phoneNumber` as a string (overriding the `parseNumbers` option):
 
 ```js
 import queryString from 'query-string';
@@ -239,7 +233,7 @@ queryString.parse('?phoneNumber=%2B380951234567&id=1', {
 //=> {phoneNumber: '+380951234567', id: 1}
 ```
 
-- `'number'`:  Parse `age` as a number (even when `parseNumber` is false):
+- `'number'`:  Parse `age` as a number (even when `parseNumbers` is false):
 
 ```js
 import queryString from 'query-string';
@@ -249,16 +243,16 @@ queryString.parse('?age=20&id=01234&zipcode=90210', {
 		age: 'number',
 	}
 });
-//=> {age: 20, id: '01234', zipcode: '90210 }
+//=> {age: 20, id: '01234', zipcode: '90210'}
 ```
 
-- `'string[]'`:  Parse `items` as an array of strings (overriding the `parseNumber` option):
+- `'string[]'`:  Parse `items` as an array of strings (overriding the `parseNumbers` option):
 
 ```js
 import queryString from 'query-string';
 
 queryString.parse('?age=20&items=1%2C2%2C3', {
-	parseNumber: true,
+	parseNumbers: true,
 	types: {
 		items: 'string[]',
 	}
@@ -266,7 +260,7 @@ queryString.parse('?age=20&items=1%2C2%2C3', {
 //=> {age: 20, items: ['1', '2', '3']}
 ```
 
-- `'number[]'`:  Parse `items` as an array of numbers (even when `parseNumber` is false):
+- `'number[]'`:  Parse `items` as an array of numbers (even when `parseNumbers` is false):
 
 ```js
 import queryString from 'query-string';
@@ -289,10 +283,10 @@ queryString.parse('?age=20&id=01234&zipcode=90210', {
 		age: (value) => value * 2,
 	}
 });
-//=> {age: 40, id: '01234', zipcode: '90210 }
+//=> {age: 40, id: '01234', zipcode: '90210'}
 ```
 
-NOTE: Array types (`string[]` and `number[]`) will have no effect if `arrayFormat` is set to `none`.
+NOTE: Array types (`string[]`, `number[]`) are ignored if `arrayFormat` is set to `'none'`.
 
 ```js
 queryString.parse('ids=001%2C002%2C003&foods=apple%2Corange%2Cmango', {
@@ -315,7 +309,7 @@ queryString.parse('?age=20&id=01234&zipcode=90210', {
 		age: (value) => value * 2,
 	}
 });
-//=> {age: 40, id: '01234', zipcode: '90210 }
+//=> {age: 40, id: '01234', zipcode: '90210'}
 ```
 
 Parse the value as a boolean type instead of string type if it's a boolean.