urlUtils.ts 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091
  1. /**
  2. * Classe permettant de construire une URL pour l'interrogation d'une API externe
  3. */
  4. class UrlUtils {
  5. /**
  6. * Concatenate a base url and a tail
  7. * @param base
  8. * @param tails
  9. * @private
  10. */
  11. public static join (base: string|number, ...tails: Array<string|number>): string {
  12. let url = String(base)
  13. tails.forEach((tail: string|number) => {
  14. url = url.replace(/^|\/$/g, '') + '/' + String(tail).replace(/^\/?|$/g, '')
  15. })
  16. return url
  17. }
  18. /**
  19. * Prepend the 'https://' part if neither 'http://' nor 'https://' prefixes are present, else does nothing
  20. *
  21. * @param url
  22. */
  23. public static prependHttps (url: string): string {
  24. if (!url.match(/^https?:\/\/.*/)) {
  25. url = 'https://' + url;
  26. }
  27. return url;
  28. }
  29. /**
  30. * Parse an URI to retrieve a parameter
  31. *
  32. * @param uri
  33. * @param parameter
  34. * @param default_
  35. * @private
  36. */
  37. public static getParameter (
  38. uri: string,
  39. parameter: string,
  40. default_: string | number | null = null
  41. ): string | number | null {
  42. uri = UrlUtils.prependHttps(uri)
  43. const urlParams = new URL(uri).searchParams;
  44. let value: string | number | null = urlParams.get(parameter);
  45. if (value && (default_ === null || Number.isInteger(default_)) && /^\d+$/.test(value)) {
  46. // On convertit automatiquement si et seulement la valeur par défaut est elle-même un entier ou n'est pas définie
  47. value = parseInt(value)
  48. }
  49. return value ?? default_
  50. }
  51. /**
  52. * Extrait l'ID de l'URI passée en paramètre
  53. * L'URI est supposée être de la forme `.../foo/bar/{id}`, où l'id est un identifiant numérique
  54. *
  55. * @param uri
  56. */
  57. public static extractIdFromUri (uri: string): number|null {
  58. const partUri: Array<string> = uri.split('/')
  59. const id: any = partUri.pop()
  60. if (!id || isNaN(id)) {
  61. throw new Error('no id found')
  62. }
  63. return parseInt(id)
  64. }
  65. /**
  66. * Découpe une URI au niveau des '/'
  67. * Utilisé entre autres pour le breadcrumb
  68. *
  69. * Ex:
  70. *
  71. * foo/bar/1 => ['foo', 'bar', '1']
  72. * /foo/bar/1 => ['foo', 'bar', '1']
  73. * https://domain.com/foo/bar/1 => ['https:', 'domain.com', 'foo', 'bar', '1']
  74. *
  75. *
  76. * @param uri
  77. */
  78. public static split(uri: string) {
  79. return uri.split('/').filter((s) => s.length > 0)
  80. }
  81. }
  82. export default UrlUtils