app/services/utils/url.ts

/**
 * Classe permettant de construire une URL pour l'interrogation d'une API externe
 */
export default class Url {
  /**
   * Concatenate a base url and a tail
   * @param base
   * @param tails
   * @private
   */
  public static join (base: string|number, ...tails: Array<string|number>): string {
    let url = String(base)
    tails.forEach((tail: string|number) => {
      url = url.replace(/^|\/$/g, '') + '/' + String(tail).replace(/^\/?|$/g, '')
    })
    return url
  }

  /**
   * Prepend the 'https://' part if neither 'http://' of 'https://' is present, else: does nothing
   *
   * @param url
   */
  public static prependHttps (url: string): string {
    if (!url.match(/^https?:\/\/.*/)) {
      url = 'https://' + url;
    }
    return url;
  }

  /**
   * Parse an URI to retrieve the parameter
   *
   * @param uri
   * @param parameter
   * @param default_
   * @private
   */
  public static getParameter(
      uri: string,
      parameter: string,
      default_: string | null = null
  ): string | null {

    const urlParams = new URL(uri).searchParams;
    const res = urlParams.get(parameter);

    return res ?? default_
  }

  /**
   * Extrait l'ID de l'URI passée en paramètre
   * L'uri est supposée être de la forme `.../foo/bar/{id}`, où l'id est un identifiant numérique
   *
   * @param uri
   */
  public static extractIdFromUri (uri: string): number|null {
    const partUri: Array<string> = uri.split('/')
    const id:any = partUri.pop()

    if(isNaN(id))
      throw new Error('id is not a number')

    return parseInt(id)
  }

  /**
   * Extrait l'Uuid de l'URI passée en paramètre
   * L'uri est supposée être de la forme `.../foo/bar/{uuid}`
   *
   * @param uri
   */
  public static extractUuidFromUri (uri: string): string|null {
    const partUri: Array<string> = uri.split('/')
    return String(partUri.pop())
  }

  /**
   * Découpe une URI au niveau des '/'
   * Utilisé entre autres pour le breadcrumb
   *
   * Ex:
   *
   *    foo/bar/1   =>  ['foo', 'bar', '1']
   *    /foo/bar/1   =>  ['foo', 'bar', '1']
   *    https://domain.com/foo/bar/1   =>  ['https:', 'domain.com', 'foo', 'bar', '1']
   *
   *
   * @param uri
   */
  public static split(uri: string) {
    return uri.split('/').filter((s) => s.length > 0)
  }
}