query-string

What is query-string?

The query-string npm package is used for parsing and stringifying URL query strings. It provides a simple API for dealing with query strings in a way that is both convenient and cross-browser compatible.

What are query-string's main functionalities?

Parsing query strings

This feature allows you to parse a query string into an object. It automatically handles various edge cases and decoding of parameters.

const queryString = require('query-string');
const parsed = queryString.parse('?foo=bar');
console.log(parsed); //=> {foo: 'bar'}

Stringifying objects

This feature enables you to take an object and convert it into a URL query string. It ensures that keys and values are properly encoded.

const queryString = require('query-string');
const stringified = queryString.stringify({foo: 'bar'});
console.log(stringified); //=> 'foo=bar'

Extracting query strings

This function extracts the query string from a URL.

const queryString = require('query-string');
const extracted = queryString.extract('http://example.com/?foo=bar');
console.log(extracted); //=> '?foo=bar'

Parsing arrays and objects

The package can parse query strings with array and object syntax, turning them into the corresponding JavaScript structures.

const queryString = require('query-string');
const parsed = queryString.parse('?foo[]=bar&foo[]=baz');
console.log(parsed); //=> {foo: ['bar', 'baz']}

Other packages similar to query-string

qs

The 'qs' package is a query string parser with nesting support. It is more feature-rich than query-string, allowing for complex structures like nested objects and arrays. However, it might be overkill for simple use cases.

url-search-params

This is a polyfill for the URLSearchParams API which is built into modern browsers. It provides similar functionality to query-string but is designed to mimic the native browser API.

querystringify

querystringify is a small and simple query string parser and stringifier. It is focused on speed and simplicity, and while it has fewer features than query-string, it may be faster in some cases.

README

query-string

Parse and stringify URL query strings

Install

Download manually or with a package-manager.

npm

npm install --save query-string

Bower

bower install --save query-string

Component

component install sindresorhus/query-string

Example using Node.js

var queryString = require('query-string');

var url = 'http://sindresorhus.com?foo=bar'.split('?');
var parsed = queryString.parse(url[1]);
console.log(parsed);
// {foo: 'bar'}

parsed.foo = 'unicorn';
parsed.ilike = 'pizza';
console.log(url[0] + '?' + queryString.stringify(parsed));
// http://sindresorhus.com?foo=unicorn&ilike=pizza

API

queryString.parse()

Parse a query string into an object.

queryString.stringify()

Stringify an object into a query string.

License

MIT © Sindre Sorhus