@jsweb/queryfetch

Dead simple JS module to parse/serialize HTTP query/params. Useful for Fetch API or AJAX requests.

Instalation

You can install using NPM, Yarn or from CDN:

CDN

<script src="https://unpkg.com/@jsweb/queryfetch"></script>

Usage

ES6+

import queryfetch from '@jsweb/queryfetch'

CommonJS

const queryfetch = require('@jsweb/queryfetch')

Global

If you install with CDN script tag, queryfetch object will be available globally.

Instance

queryfetch is a function that returns a class object constructor.

It needs to receive a source argument which will be used at methods execution.

Examples:

const str = queryfetch('a=1&b=2&c=3'),
    obj = queryfetch({ a: 1, b: 2, c: 3 })

Methods

There are only 3 methods within queryfetch:

str.parse()

It converts a querystring to a literal Object.

const str = queryfetch('a=1&b=2&c=3') // with or without first '?' char

str.parse()   // returns { a: 1, b: 2, c: 3 }

obj.serialize()

Serializes a literal Object to a querystring.

const obj = queryfetch({ a: 1, b: 2, c: 3 })

obj.serialize()   // returns 'a=1&b=2&c=3'

qf.form()

This method is a bonus to build a FormData instance.

It can receive an entry as querystring, literal Object or HTMLFormElement.

let qf = queryfetch(any) // querystring, literal Object or HTMLFormElement

qf.form()   // returns FormData instance with fields/values