Awesome-querystring NPM

Created out of a frustration with the node default querystring as well as for TypeScript based projects that do not require @types/node

Install

Install with yarn:

$ yarn add awesome-querystring

Usage

Stringify

Create a querystring from a JS object

const { stringify } = require('awesome-querystring');
// or for TypeScript:
// import { stringify } from 'awesome-querystring';

console.log(stringify({prop: 'value', prop2: 'value2'}));
//=> '?prop=value&prop2=value2'

// supply options
console.log(stringify({prop: 'value', prop2: 'value2'}, {separator: '&', equals: '=', includeQuestion: true}));
//=> '?prop=value&prop2=value2'

// customize options
console.log(stringify({prop: 'value', prop2: 'value2'}, {separator: '&&', equals: '=', includeQuestion: false}));
//=> 'prop=value&&prop2=value2'

Parse

Create a JS object from a querystring

const { parse } = require('awesome-querystring');
// or for TypeScript:
// import { parse } from 'awesome-querystring';

console.log(parse('?prop=value&prop2=value2'));
//=> {prop: 'value', prop2: 'value2'}

// supply options
console.log(parse('?prop=value&prop2=value2', {separator: '&', equals: '='}));
//=> {prop: 'value', prop2: 'value2'}

// customize options
console.log(parse('prop=value&&prop2=value2', {separator: '&&', equals: '='}));
//=> {prop: 'value', prop2: 'value2'}

Documentation

Functions

Typedefs

stringify(obj, options) ⇒ string

Kind: global function

Param	Type	Description
obj	IAwesomeQuerystringObject	Object to stringify
options	IStringifyOptions	Options for the stringify, see IStringifyOptions

parse(qs, options) ⇒ IAwesomeQuerystringObject

Kind: global function

Param	Type	Description
qs	string	Querystring to parse
options	IParseOptions	Options for the parse, see IParseOptions

IStringifyOptions : IStringifyOptions

Kind: global typedef
Properties

Name	Type	Description
separator	string	separator the querystring should get
equals	string	equals sign the querystring should use
includeQuestion	boolean	whether the querystring should be prefixed with a ?

IParseOptions : IParseOptions

Kind: global typedef
Properties

Name	Type	Description
separator	string	separator the querystring has
equals	string	equals sign the querystring has

About

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

License

Buy me a donut

This project is open source and always will be, even if I don't get donations. That said, I know there are people out there that may still want to donate just to show their appreciation so this is for you guys. Thanks in advance!

I accept donations through PayPal, BitCoin, Ethereum and LiteCoin. You can use the buttons below to donate through your method of choice