[NoQA] LocaleCompare util tests

src/libs/LocaleCompare.ts

@@ -14,6 +14,14 @@ Onyx.connect({
     },
 });
 
+/**
+ * This is a wrapper around the localeCompare function that uses the preferred locale from the user's settings.
+ *
+ * It re-uses Intl.Collator for performance reasons. See https://github.com/facebook/hermes/issues/867 for more details.
+ * @param a
+ * @param b
+ * @returns -1 if a < b, 1 if a > b, 0 if a === b
+ */
 function localeCompare(a: string, b: string) {
     return collator.compare(a, b);
 }

tests/unit/LocaleCompareTest.js

@@ -0,0 +1,27 @@
+const {default: localeCompare} = require('@libs/LocaleCompare');
+
+describe('localeCompare', () => {
+    it('should return -1 for descending comparison', () => {
+        const result = localeCompare('Da Vinci', 'Tesla');
+
+        expect(result).toBe(-1);
+    });
+
+    it('should return -1 for ascending comparison', () => {
+        const result = localeCompare('Zidane', 'Messi');
+
+        expect(result).toBe(1);
+    });
+
+    it('should return 0 for equal strings', () => {
+        const result = localeCompare('Cat', 'Cat');
+
+        expect(result).toBe(0);
+    });
+
+    it('should discard sensitivity differences', () => {
+        const result = localeCompare('apple', 'Apple');
+
+        expect(result).toBe(0);
+    });
+});