nested-query-parser

Parse nested JSON to readable URL query string.

Install

$ npm install nested-query-parser

Not npm install nested-query-parser!!!!!

This module targets Node.js 6 or later and the latest version of Chrome, Firefox, and Safari.

Usage

const qp = require('nested-query-parser');

const query = { 
    foo:"bar",
    fizz:"buzz"
 }

const queryString = qp.encode(query);
console.log(queryString);
//=> {?foo=bar&fizz=buzz}

const queryJson = qp.decode(queryString);
console.log(queryJson);
//=> { foo:"bar", fizz:"buzz" }

API

.encode( object )

The encode method transforms a given JSON/Array in to a query string. By default we return the query string with a ? prefix.

const qp = require('nested-query-parser');

qp.encode({ foo: 'bar' });                //=> ?foo=bar
qp.encode({ foo: '' });                   //=> ?foo=
qp.decode({ num: 2.2, str: '2.2' })       //=> ?num=%2.2%&str=2.2 
qp.encode({ foo: ['b','a'] });            //=> ?foo:[0]=b&foo:[1]=a
qp.encode({ foo:true, bar:false })        //=> ?foo=%TRUE%&bar=%FALSE%
qp.encode({ a:{ b:{ c: ['c1','c2'] } })   //=> ?a:b:c:[0]=c1&a:b:c:[1]=c2

.decode( string )

The decode method transforms a given query string in to an object. Parameters without values are set to empty strings.It extracts keys and values between & = and covert reserved words to javascript keywords.

const qp = require('nested-query-parser');

qp.decode('?foo=bar');                    //=> { foo: 'bar' }
qp.decode('?num=%2.2%&str=2.2');          //=> { num: 2.2, str: '2.2' }
qp.decode('?and=%AND%');                  //=> { and: '&' }
qp.decode('?question=%QUESTION%');        //=> { question: '?' }
qp.decode('?equal=%EQUAL%');              //=> { equal: '=' }
qp.decode('?null=%NULL%');                //=> { null: null }

Reserved Symbols and Keywords

Symbols and keywords are reserved to avoid bugs introduced while decoding string in a readable way.

Encoded Keyword	Decoded Keyword
"%EQUAL%"	"="
"%QUESTION%"	"?"
"%PLUS%"	"+"
"%COLON%"	":"
"%AND%"	"&"
"%PERCENT%"	"%"
"%LBRAC%"	"["
"%RBRAC%"	"]"
"%NULL%"	null
"%UNDEFINED%"	undefined
"%FALSE%"	false
"%TRUE%"	true
"%23.21%" ( any_number )	23.21

Contribution

Open to contribution and updates to make this library more versatile

License

Apache 2.0