urlUtils.ts 2.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  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}`,
  54. * où l'id est un identifiant numérique, à moins que isLiteral soit défini comme vrai.
  55. * Dans ce cas, si isLiteral est vrai, l'id sera retourné sous forme de texte.
  56. *
  57. *
  58. * @param uri
  59. * @param isLiteral
  60. */
  61. public static extractIdFromUri (uri: string, isLiteral: boolean = false): number|string|null {
  62. const partUri: Array<string> = uri.split('/')
  63. const id: string = partUri.pop() ?? ''
  64. if (!id || (!isLiteral && isNaN(id as any))) {
  65. throw new Error('no id found')
  66. }
  67. return isLiteral ? id : parseInt(id)
  68. }
  69. /**
  70. * Découpe une URI au niveau des '/'
  71. * Utilisé entre autres pour le breadcrumb
  72. *
  73. * Ex:
  74. *
  75. * foo/bar/1 => ['foo', 'bar', '1']
  76. * /foo/bar/1 => ['foo', 'bar', '1']
  77. * https://domain.com/foo/bar/1 => ['https:', 'domain.com', 'foo', 'bar', '1']
  78. *
  79. *
  80. * @param uri
  81. */
  82. public static split(uri: string) {
  83. return uri.split('/').filter((s) => s.length > 0)
  84. }
  85. }
  86. export default UrlUtils