Miss any of our Open RFC calls?Watch the recordings here! »

params-url

1.2.0 • Public • Published

params-url params-url

Params Url

Serialize params from object to URL.

Install

$ npm i params-url -S

or use CDN:

<script src="https://cdn.jsdelivr.net/npm/params-url@latest/build/urlparams.build.js"></script>

Tests

$ npm test

Usage

const urlParams = require('params-url')

Methods

.add (url, params)

Parameter Type Requried
url string yes
params object yes

Returns a new url with new parameters.

const url = urlParams.add('https://api.com?q=dogs', {
  act: 'find',
  type: [ 'good', 'beautiful' ],
  v: 2
})
 
console.log(url)
// => https://api.com?q=test&act=create&v=2

.delete (url, params)

Returns a new url without the specified parameters.

Parameter Type Requried
url string yes
params array yes
const url = urlParams.delete('https://api.com?q=dogs&act=find&type=good&type=beautiful', [
  'q',
  'type'
])
 
console.log(url)
// => https://api.com?v=2

.generate (url, params)

Parameter Type Requried
url string yes
params object yes

Returns a url with parameters.

const url = urlParams.generate('https://api.com/', {
  q: 'dogs',
  act: 'find',
  type: [ 'good', 'beautiful', 'husky' ],
  v: 2
})
 
console.log(url)
// => https://api.com?foo=bar&q=example%20with%20spaces&arr=1&arr=2&arr=3&v=2

.parse (url)

Parameter Type Requried
url string yes

Returns object of parameters.

const url = urlParams.parse('https://api.com?q=dogs&act=find&type=good&type=beautiful&type=husky&v=2')
 
console.log(url)
// {
//   q: 'dogs',
//   act: 'find',
//   type: [ 'good', 'beautiful', 'husky' ],
//   v: '2'
// }

License

MIT.

Install

npm i params-url

DownloadsWeekly Downloads

0

Version

1.2.0

License

MIT

Last publish

Collaborators

  • avatar