feat: string equals ignore case

Author: KatoakDR

electron/common/string/__tests__/string-utils.test.ts

@@ -1,4 +1,4 @@
-import { includesIgnoreCase } from '../string.utils';
+import { equalsIgnoreCase, includesIgnoreCase } from '../string.utils';
 
 describe('string-utils', () => {
   describe('#includesIgnoreCase', () => {
@@ -29,4 +29,60 @@ describe('string-utils', () => {
       expect(result).toBe(true);
     });
   });
+
+  describe('#equalsIgnoreCase', () => {
+    test('when the values are equal then returns true', () => {
+      const value1 = 'foo';
+      const value2 = 'foo';
+
+      const result = equalsIgnoreCase(value1, value2);
+
+      expect(result).toBe(true);
+    });
+
+    test('when the values are not equal then returns false', () => {
+      const value1 = 'foo';
+      const value2 = 'bar';
+
+      const result = equalsIgnoreCase(value1, value2);
+
+      expect(result).toBe(false);
+    });
+
+    test('when the values are equal but with different casing then returns true', () => {
+      const value1 = 'foo';
+      const value2 = 'FOO';
+
+      const result = equalsIgnoreCase(value1, value2);
+
+      expect(result).toBe(true);
+    });
+
+    test('when first value is undefined then returns false', () => {
+      const value1 = undefined;
+      const value2 = 'foo';
+
+      const result = equalsIgnoreCase(value1, value2);
+
+      expect(result).toBe(false);
+    });
+
+    test('when second value is undefined then returns false', () => {
+      const value1 = 'foo';
+      const value2 = undefined;
+
+      const result = equalsIgnoreCase(value1, value2);
+
+      expect(result).toBe(false);
+    });
+
+    test('when both values are undefined then returns true', () => {
+      const value1 = undefined;
+      const value2 = undefined;
+
+      const result = equalsIgnoreCase(value1, value2);
+
+      expect(result).toBe(true);
+    });
+  });
 });

electron/common/string/string.utils.ts

@@ -1,10 +1,15 @@
+import type { Maybe } from '../types';
+
 export const includesIgnoreCase = (
   values: Array<string>,
   valueToFind: string
 ): boolean => {
   return values.some((value) => equalsIgnoreCase(value, valueToFind));
 };
 
-export const equalsIgnoreCase = (a: string, b: string): boolean => {
+export const equalsIgnoreCase = (
+  a: Maybe<string>,
+  b: Maybe<string>
+): boolean => {
   return a?.toLowerCase() === b?.toLowerCase();
 };