util code for nodejs

addQueryToUrl.js

"use strict";

/**
 * adds an object as query to the given url
 * @param url
 * @param {object} query
 * @returns {string} url with the extra query parameters
 */
function addQueryToUrl(url, query) {
	if(!url) return '';
	if(!query) return url;

	const parsedUrl = require('url').parse(url, true);
	Object.assign(parsedUrl.query, query);

	// needed in order for the URL to parse the query field instead of the search field
	// Documentation => on url.format: query (object; see querystring) will only be used if search is absent.
	delete parsedUrl.search;

	return parsedUrl.format();
}

module.exports = {
	addQueryToUrl
}