Skip to content

Instantly share code, notes, and snippets.

@excalq
Last active March 19, 2024 17:45
Show Gist options
  • Save excalq/2961415 to your computer and use it in GitHub Desktop.
Save excalq/2961415 to your computer and use it in GitHub Desktop.
Javacript: Set or Update a URL/QueryString Parameter, and update URL using HTML history.replaceState()
// 2024 Update, use URLSearchParams [https://caniuse.com/urlsearchparams]
export function createQueryString2(name: string, value: string, searchParams: any) {
const params = new URLSearchParams(searchParams);
params.set(name, value.toLowerCase());
return params.toString();
}
// ---- Original 2012 version, when browsers really sucked ----
// Explicitly save/update a url parameter using HTML5's replaceState().
function updateQueryStringParam(param, value) {
baseUrl = [location.protocol, '//', location.host, location.pathname].join('');
urlQueryString = document.location.search;
var newParam = key + '=' + value,
params = '?' + newParam;
// If the "search" string exists, then build params from it
if (urlQueryString) {
keyRegex = new RegExp('([\?&])' + key + '[^&]*');
// If param exists already, update it
if (urlQueryString.match(keyRegex) !== null) {
params = urlQueryString.replace(keyRegex, "$1" + newParam);
} else { // Otherwise, add it to end of query string
params = urlQueryString + '&' + newParam;
}
}
window.history.replaceState({}, "", baseUrl + params);
}
@johnrees
Copy link

johnrees commented Oct 5, 2017

If you're not using IE/Edge this can be achieved with URLSearchParams

const params = new URLSearchParams(location.search);
params.set('test', 123);
window.history.replaceState({}, '', `${location.pathname}?${params}`);

@shr33narayan
Copy link

@johnrees that's great. 👍

@dibakarjana
Copy link

dibakarjana commented Jun 4, 2018

Can anyone please show me how do I implement updateQueryStringParam() in a <button> or <a> or <select> [onChange]?

@mbuguaMaina
Copy link

mbuguaMaina commented Feb 4, 2024

Thanks for the code snippet and sharing your thoughts – but I noted when using the code , updateQueryStringParam() adds a "?" every time, so, here is my solution around this;

export const createQueryString = (key: string, value: string) => {
   		var  urlQueryString = document.location.search,
   		newParam = key + '=' + value,
                      params = '?' + newParam; //replace this line with the one below
   		params = newParam;

   	// If the "search" string exists, then build params from it
   	if (urlQueryString) {
   		let keyRegex = new RegExp('([?&])' + key + '[^&]*');

   		// If param exists already, update it
   		if (urlQueryString.match(keyRegex) !== null) {
params = urlQueryString.replace(keyRegex, "$1" + newParam);//replace this line with the one below
   			params = urlQueryString.replace(keyRegex, newParam);
   		} else {
   			// Otherwise, add it to end of query string
   			params = urlQueryString + '&' + newParam;
   		}
   	}
   	// window.history.replaceState({}, "", baseUrl + params);
   	return params;
}

@mbuguaMaina
Copy link

Add here is a better solution for the same

export function createQueryString2(name: string, value: string, searchParams: any) {
		const params = new URLSearchParams(searchParams);
		params.set(name, value.toLowerCase());

		return params.toString();
	}

the function takes care of repalcing the value of a key if already exists

@excalq
Copy link
Author

excalq commented Mar 19, 2024

Thanks @mbuguaMaina, URLSearchParams is definitely the best modern approach. I've updated the original Gist to use your version.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment