**URL Validation Query** URL Validation Query is a utility library providing a range of functions for managing query strings in web applications. It offers features for validating, decoding, and parsing query string parameters, as well as inspecting the c
npm install url-validation-queryURL Validation Query
URL Validation Query is a utility library providing a range of functions for managing query strings in web applications. It offers features for validating, decoding, and parsing query string parameters, as well as inspecting the current environment and extracting the search query from the URL.
Installation
You can install the package using npm or yarn:
``bash`
npm install url-validation-query
or
`bash`
yarn add url-validation-query
`bash`
pnpm install url-validation-query
Usage
Import the desired functions from the package:
`javascript`
import { validateParams, toQueryString, parseBoolean, isClient, getSearchQuery } from 'url-validation-query';
Functions
1. validateParams
Validates query string parameters by removing any keys with falsy values.
`javascript
import { validateParams } from 'url-validation-query';
const validParams = validateParams({ foo: 'bar', abc: '', def: null });
// { foo: 'bar' }
`
2. toQueryString
Decodes query string values by removing any keys with falsy values and decoding the resulting query string.
`javascript
import { toQueryString } from 'url-validation-query';
const decodedQueryString = toQueryString({ foo: 'bar', abc: 'xyz' });
// 'foo=bar&abc=xyz'
`
3. parseBoolean
Parses boolean values from query strings. It returns true for any non-falsy string value, and false for falsy string values (case-insensitive "f", "false", "n", "no", and "0").
`javascript
import { parseBoolean } from 'url-validation-query';
const isTrue = parseBoolean('true'); // true
const isFalse = parseBoolean('false'); // false
`
4. isClient
Checks if the current environment is a client-side environment (browser).
`javascript
import { isClient } from 'url-validation-query';
if (isClient()) {
// Client-side code
} else {
// Server-side code
}
`
5. getSearchQuery
Retrieves the search query from the current URL and parses it using the query-string library. It accepts options for configuring the parsing behavior.
`javascript
import { getSearchQuery } from 'url-validation-query';
const URL = "?foo=bar&abc=xyz&isSort=true&categoryId=1,2,3" // or window.location.search
const searchQuery = getSearchQuery({ searchParams: search || URL },{ parseNumbers: true , parseBooleans: true , arrayFormat:"comma" }); // {foo: "bar", abc:"xyz", isSort:true, categoryId: [1,2,3]}
``
Support
If you encounter any issues or have questions, please feel free to reach out to us at garmabi.mohammad73@gmail.com.