@aaronhayes/qstring

qstring

The easiest way to build querystrings. A lightweight, easy to use way to build full urls including the querystring. Less than 400B Minified & GZipped!

The popular query-string only handles the part querystring part, so there is another step of building the final url. The API inspired by JedWatson's Classnames Package.

Install

$ npm install --save @aaronhayes/qstring

$ yarn add @aaronhayes/qstring

Usage

import qstring, { ArrayFormat } from '@aaronhayes/qstring';

const qs = qstring('https://myapi.com', {
    foo: 'bar',
    foobar: true,
    foo3: null,
    foo4: undefined
});

console.log(qs);
// https://myapi.com?foo=bar&foobar=true

const qs = qstring(
    'https://myapi.com',
    {
        foo: ['hello', 'world'],
        cat: 'dog'
    }
);

console.log(qs);
// https://myapi.com?foo=hello&foo=world&cat=dog

const qs = qstring(
    'https://myapi.com',
    {
        foo: ['hello', 'world'],
        cat: 'dog'
    },
    ArrayFormat.comma
);

console.log(qs);
// https://myapi.com?foo=hello,world&cat=dog

See Also

• query-string
• Classnames
• Typescript Starter