rob-pw/qurl

A JavaScript library for getting and setting query parameters.

Qurl

Qurl is a browser JavaScript library for getting and setting query parameters. This library makes use of Window Location and pushState to operate.

Usage

Create a new Qurl instance, accepts an optional queryString as a parameter to the constructor.

var url = new Qurl(/* queryString */);
// or
var url = Qurl(/* queryString */);

Get the query parameters as an object.

obj = url.query();

Get query parameters as a string

url.toString();

Get the value of a single query parameter by passing its key as an argument.

key = url.query('key');

Set the value for a query parameter.

url.query('key', 'value');
url.query('Robby', {
  age: 20,
  friends : ['Martin', 'Mole', 'Mindy'],
  stuffs : [{ foo: 'bar' }, { gum: 'ball' }],
  even : { deeper : down : [1,2,3] }
});

Delete a query parameter.

url.remove('key');
url.removeAll();

Toggle auto updating of URL history

url.updateHistory = true;

Version History

• v0.1.2 - 2014-03-19

  • Only use pushState when supported

• v0.1.1 - 2014-02-08

  • Fixed a bug where the last query parameter could not be removed

• v0.1.0 - 2014-02-07

  • Initial