Querystring decoder and encoder using URLSearchParams.

• Pre-requisite
• Install
• Usage
  • TypeScript or ES Modules
• API Reference
  • parse(searchParams[, options])
  • stringify(value)
• Contributing
  • Code of Conduct
• License

• ES Modules

# Install via NPM
$ npm i tyqs

import { parse } from 'tyqs';

parse('a=a'); // { a: 'a' }
parse('a=a&a=b'); // { a: ['a', 'b'] }
parse('a=a,b'); // { a: ['a', 'b'] }
parse('a.a=a'); // { a: { a: 'a' } }
parse('a[a]=a'); // { a: { a: 'a' } }
parse('a[a].b=a'); // { a: { a: { b: 'a' } } }
parse('a[a].b=a,b'); // { a: { a: { b: ['a', 'b'] } } }

• searchParams <string | URLSearchParams> URL search parameters.
• options <?object> Optional parsing options.
  • singles <?Array<string>> A list of keys that need to be decoded as single string value instead of an array of values.
  • smart <?boolean> Defaults to true. The decoder will assume all URL search params to be an array of values. With smart mode enabled, it will not force a single-value search param into an array.
• returns: <object> An object of decoded URL search params from a given string.

This method decodes/ parses a string value into an object.

• value <unknown> Any value of unknown type. It accepts any JavaScript primitives and objects.
• returns: <string> A string of encoded URL search params from a given input.

This method encodes/ stringifies an input into a string.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

MIT License © Rong Sen Ng (motss)