Add utility to convert duration to milliseconds

This commit introduces a new utility function that converts a duration value into a numeric value representing milliseconds. The duration input can be either a string or a number. If the duration is already a number, the function simply returns the input value. This utility will help standardize duration values across the codebase and improve the readability and maintainability of the code.

Author: Hector Arce De Las Heras

src/utils/stringUtility/string.utility.test.ts

@@ -1,8 +1,28 @@
-import { maxCountBetweenChars } from './string.utility';
+import { convertDurationToNumber, maxCountBetweenChars } from './string.utility';
 
 describe('Cursor', () => {
   it('maxCountBetweenChars - should return 3', () => {
     const position = maxCountBetweenChars('#', '## - ## - ##');
     expect(position).toBe(3);
   });
+  it('maxCountBetweenChars - should return 0', () => {
+    const position = maxCountBetweenChars('#');
+    expect(position).toBe(0);
+  });
+  it('convertDurationToNumber - should return 0', () => {
+    const duration = convertDurationToNumber();
+    expect(duration).toBe(0);
+  });
+  it('convertDurationToNumber - should return same value', () => {
+    const duration = convertDurationToNumber(0.3);
+    expect(duration).toBe(0.3);
+  });
+  it('convertDurationToNumber - should return convert string', () => {
+    const duration = convertDurationToNumber('0.3s');
+    expect(duration).toBe(300);
+  });
+  it('convertDurationToNumber - should return convert string (ms)', () => {
+    const duration = convertDurationToNumber('300ms');
+    expect(duration).toBe(300);
+  });
 });

src/utils/stringUtility/string.utility.ts

@@ -24,3 +24,24 @@ export const maxCountBetweenChars = (charCount: string, value?: string): number
   });
   return max;
 };
+
+// The function is designed to convert a duration value, which could be a string or a number, into a numeric value representing milliseconds
+// If duration is already a number, it simply returns the number.
+export const convertDurationToNumber = (duration?: string | number): number => {
+  if (!duration) {
+    return 0;
+  }
+  if (typeof duration === 'number') {
+    return duration;
+  }
+
+  // Remove "ms" or "s" from the duration and convert it to a number
+  const value = Number(duration.replace('ms', '').replace('s', ''));
+
+  // If the duration was in seconds, convert it to milliseconds
+  if (duration.includes('s') && !duration.includes('ms')) {
+    return value * 1000;
+  }
+
+  return value;
+};