urlq
A lightweight library to get/set url query string values.Usage
const urlq = require('urlq');
const q1 = '?sections=carbs,dessert&diets=gluten-free';
urlq.getParam(q1, 'sections')
=> ['carbs', 'dessert']
urlq.getParam(q1, 'diets')
=> ['gluten-free']
urlq.getParam(q1, 'non-existing')
=> []
var q2 = urlq.addVal(q1, 'sections', 'soups');
q2;
=> '?sections=carbs,dessert,soups&diets=gluten-free'
urlq.updateQuery(q2);
urlq.getParam(window.location.search, 'sections');
=> ['carbs', 'dessert', 'soups']
var q3 = urlq.updateParam(q2, 'diets', ['vegetarian', 'pescepescetarian']);
urlq.removeParam(q2, 'sections');
q3;
=> '?diets=vegetarian,pescepescetarian'
Functions
- addVal(q, p, v) ⇒
String
Returns a new query string with values added to a query parameter.
- getParam(q, p) ⇒
Array
Returns an array of values for a query parameter.
- makeValidQuery(q) ⇒
String
Returns a valid formatted url query string
- removeVal(q, p, v) ⇒
String
Returns a new query string with a value removed from a parameter.
- removeParam(q, p) ⇒
String
Returns a new query string with a parameter removed.
- updateParam(q, p, vs) ⇒
String
Returns a new query string with updated values from a parameter. If newVals.length = 0 the parameter is removed.
- updateQuery(q)
Updates the browser history with a new query string.
addVal(q, p, v) ⇒ String
Returns a new query string with values added to a query parameter.Kind: global function
| Param | Type | Description | | --- | --- | --- | | q |
String
| The query string. |
| p | String
| The query parameter to update. |
| v | \*
| The value to add. |getParam(q, p) ⇒ Array
Returns an array of values for a query parameter.Kind: global function
| Param | Type | Description | | --- | --- | --- | | q |
String
| The query string. |
| p | String
| The query parameter. |makeValidQuery(q) ⇒ String
Returns a valid formatted url query stringKind: global function
| Param | Type | Description | | --- | --- | --- | | q |
String
| The query string to format. |removeVal(q, p, v) ⇒ String
Returns a new query string with a value removed from a parameter.Kind: global function
| Param | Type | Description | | --- | --- | --- | | q |
String
| The query string to update. |
| p | String
| The parameter to remove the value. |
| v | String
| The value to remove from a parameter. |removeParam(q, p) ⇒ String
Returns a new query string with a parameter removed.Kind: global function
| Param | Type | Description | | --- | --- | --- | | q |
String
| The query string to update. |
| p | String
| The parameter to remove. |updateParam(q, p, vs) ⇒ String
Returns a new query string with updated values from a parameter.
If newVals.length = 0 the parameter is removed.Kind: global function
| Param | Type | Description | | --- | --- | --- | | q |
String
| The query string to update. |
| p | String
| The param to update. |
| vs | Array
| The new values for the param. |updateQuery(q)
Updates the browser history with a new query string.Kind: global function
| Param | Type | Description | | --- | --- | --- | | q |
String
| The new query string. |Test
npm test