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 '';
  }

  // Cast number values to strings
  if (typeof param.value === 'number') {
    param.value += '';
  }

  if (!strict || param.value) {
    // Don't encode ',' in values
    const value = util.flexibleEncodeComponent(param.value || '').replace(/%2C/gi, ',');
    const name = util.flexibleEncodeComponent(param.name || '');

    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) {
  if (!qs) {
    return [];
  }

  const stringPairs = qs.split('&');
  const pairs = [];

  for (let stringPair of stringPairs) {
    // NOTE: This only splits on first equals sign. '1=2=3' --> ['1', '2=3']
    const [encodedName, ...encodedValues] = stringPair.split('=');
    const encodedValue = encodedValues.join('=');

    let name = '';
    try {
      name = decodeURIComponent(encodedName || '');
    } catch (e) {
      // Just leave it
      name = encodedName;
    }

    let value = '';
    try {
      value = decodeURIComponent(encodedValue || '');
    } catch (e) {
      // Just leave it
      value = encodedValue;
    }

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

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

  return pairs;
}