insomnia/app/common/querystring.js

import * as util from './misc.js';

/** Join a URL with a querystring  */
export function joinURL (url, qs) {
  if (!qs) {
    return url;
  }

  // TODO: Make this work with URLs that have a #hash component
  url = url || '';
  return url + getJoiner(url) + qs;
}

export function getJoiner (url) {
  url = url || '';
  return url.indexOf('?') === -1 ? '?' : '&';
}

/** Build a querystring param out of a name/value pair */
export function build (param, strict = true) {
  // Skip non-name ones in strict mode
  if (strict && !param.name) {
    return '';
  }

  if (!strict || param.value) {
    const name = util.flexibleEncodeComponent(param.name || '');
    const value = util.flexibleEncodeComponent(param.value || '');
    return `${name}=${value}`
  } else {
    return util.flexibleEncodeComponent(param.name);
  }
}

/**
 * Build a querystring from a list of name/value pairs
 * @param parameters
 * @param strict allow empty names and values
 */
export function buildFromParams (parameters, strict = true) {
  let items = [];
  for (const param of parameters) {
    let built = build(param, strict);

    if (!built) {
      continue;
    }

    items.push(built);
  }

  return items.join('&');
}

/**
 * Deconstruct a querystring to name/value pairs
 * @param qs
 * @param strict allow empty names and values
 */
export function deconstructToParams (qs, strict = true) {
  const stringPairs = qs.split('&');
  const pairs = [];

  for (let stringPair of stringPairs) {
    const tmp = stringPair.split('=');

    const name = decodeURIComponent(tmp[0] || '');
    const value = decodeURIComponent(tmp[1] || '');

    if (strict && !name) {
      continue;
    }

    pairs.push({name, value});
  }

  return pairs;
}