url-params-helper

A JavaScript utility that allows for easy retrieval and manipulation of URL parameters.

Usage

getParams(
  [pageURL]     String indicating the URL to retrieve parameters from. Defaults to the current page URL.
)

Returns an object dictionary with key value pairs of URL parameter names and values, or null if there are no URL parameters.

getParam(
  param           String indicating the URL parameter name.
  [, pageURL]     String indicating the URL to retrieve parameters from. Defaults to the current page URL.
)

Returns the value of the specified URL parameter, or null if it does not exist and/or is empty.

buildQueryString(
  params          Object with key value pairs of URL parameter names and values.
)

Returns a query string with the specified URL parameters. Null-value parameters will be included in the returned query string, but undefined parameters will not.

buildQueryStringURL(
  params          Object with key value pairs of URL parameter names and values.
  [, pageURL]     String indicating the URL to retrieve parameters from. Defaults to the current page URL.
)

Returns a query string URL with the specified URL parameters. Null-value parameters will be included in the returned query string URL, but undefined parameters will not.

removeParam(
  param           String indicating the URL parameter name.
  [, pageURL]     String indicating the URL to retrieve parameters from. Defaults to the current page URL.
)

Returns a URL with the specified URL parameter removed.

replaceParam(
  param,          String indicating the URL parameter name.
  value           Mixed value for the URL parameter.
  [, pageURL]     String indicating the URL to retrieve parameters from. Defaults to the current page URL.
)

Returns a URL with the specified URL parameter replaced. If the URL parameter does not already exist, it will be set.

License

Copyright 2016 Alvin Teh. Licensed under the MIT license.