/** * 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 { 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 = 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 = 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) } }