| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131 |
- import _ from "lodash";
- /**
- * Classe permettant de construire une URL pour l'interrogation d'une API externe
- */
- class UrlUtils {
- /**
- * 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://' nor 'https://' prefixes are 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 a parameter
- *
- * @param uri
- * @param parameter
- * @param default_
- * @private
- */
- public static getParameter (
- uri: string,
- parameter: string,
- default_: string | number | null = null
- ): string | number | null {
- uri = UrlUtils.prependHttps(uri)
- const urlParams = new URL(uri).searchParams;
- let value: string | number | null = urlParams.get(parameter);
- if (value && (default_ === null || Number.isInteger(default_)) && /^\d+$/.test(value)) {
- // On convertit automatiquement si et seulement la valeur par défaut est elle-même un entier ou n'est pas définie
- value = parseInt(value)
- }
- return value ?? 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, à moins que `isLiteral` soit défini comme vrai.
- * Dans ce cas, si `isLiteral` est vrai, l'id sera retourné sous forme de texte.
- *
- * @param uri
- * @param isLiteral
- */
- public static extractIdFromUri (uri: string, isLiteral: boolean = false): number|string|null {
- const partUri: Array<string> = uri.split('/')
- const id: string = partUri.pop() ?? ''
- if (!id || (!isLiteral && isNaN(id as any))) {
- throw new Error('no id found')
- }
- return isLiteral ? id : parseInt(id)
- }
- /**
- * 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)
- }
- /**
- * Format and add a query to an url
- * If the url already has a query, append the new parameters to it.
- * If the query is an empty object, does nothing.
- *
- * Ex:
- * addQuery('foo/bar', {}) => 'foo/bar'
- * addQuery('foo/bar', {'a': 1}) => 'foo/bar?a=1'
- * addQuery('foo/bar?a=1', {'b': 2}) => 'foo/bar?a=1&b=2'
- *
- * @param url
- * @param query
- */
- public static addQuery(url: string | URL, query: object): string {
- let urlObj = new URL(url, 'https://temporary-dommain.inexistent') as URL
- if (!_.isEmpty(query)) {
- urlObj = new URL(
- `${urlObj.origin}${urlObj.pathname}${urlObj.hash}?${new URLSearchParams([
- ...Array.from(urlObj.searchParams.entries()),
- ...Object.entries(query),
- ])}`
- )
- }
- let result = urlObj.toString()
- if (urlObj.host === 'temporary-dommain.inexistent') {
- result = result.replace('https://temporary-dommain.inexistent', '')
- }
- return result
- }
- }
- export default UrlUtils
|