js:javascript_urlsearchparams

Javascript URLSearchParams

URLSearchParams is an JavaScript Object that handle the search/query parameters in your URL. Details can be find in https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams

Assume you have the query/search part of the URL. You can create an URLSearchParams object by:

var paramsString = "q=URLUtils.searchParams&topic=api";
var searchParams = new URLSearchParams(paramsString);

//Iterate the search parameters.
for (let p of searchParams) {
  console.log(p);
}
searchParams.has("topic") === true; // true
searchParams.get("topic") === "api"; // true

Note that DO NOT USE THE WHOLE URL as the parameter! It will not work! Use the search/query part string only! If the string have a leading ?, URLSearchParams will strip it on create.

Most of the time we use get, has, for loop them through. Here is a list of URLSearchParams methods from https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams

URLSearchParams.append()
    Appends a specified key/value pair as a new search parameter.
URLSearchParams.delete()
    Deletes the given search parameter, and its associated value, from the list of all search parameters.
URLSearchParams.entries()
    Returns an iterator allowing iteration through all key/value pairs contained in this object.
URLSearchParams.forEach()
    Allows iteration through all values contained in this object via a callback function.
URLSearchParams.get()
    Returns the first value associated with the given search parameter.
URLSearchParams.getAll()
    Returns all the values associated with a given search parameter.
URLSearchParams.has()
    Returns a Boolean indicating if such a given parameter exists.
URLSearchParams.keys()
    Returns an iterator allowing iteration through all keys of the key/value pairs contained in this object.
URLSearchParams.set()
    Sets the value associated with a given search parameter to the given value. If there are several values, the others are deleted.
URLSearchParams.sort()
    Sorts all key/value pairs, if any, by their keys.
URLSearchParams.toString()
    Returns a string containing a query string suitable for use in a URL.
URLSearchParams.values()
    Returns an iterator allowing iteration through all values of the key/value pairs contained in this object. 
  • js/javascript_urlsearchparams.txt
  • Last modified: 2020/09/16 15:50
  • by chongtin