@colijnit/corecomponents_v12 12.0.13 → 12.0.16

package/src/lib/core/utils/array-utils.spec.ts

@@ -1,588 +0,0 @@
-import {ArrayUtils} from "./array-utils";
-
-// NOTE: the commented-out specs are methods which aren't yet in OUR ArrayUtils, but still only in ArrayUtils of iOneJS
-describe("ArrayUtils", () => {
-    // [0, 1, 2, 3, 4, 5]
-    let numberArray: number[];
-    let numberArrayLenOrig: number;
-
-    let objectArray: any[];
-    let objectArrayLenOrig: number;
-    const objectOne: any = {data: 'one'};
-    const objectTwo: any = {data: 'two'};
-    const objectThree: any = {data: 'three'};
-    const objectFour: any = {data: 'four'};
-
-    function setupBeforeEachNumberArr(): void {
-        beforeEach(() => {
-            numberArray = [
-                0, 1, 2, 3, 4, 5
-            ];
-            numberArrayLenOrig = numberArray.length;
-        });
-    }
-
-    function setupBeforeEachObjectArr(): void {
-        beforeEach(() => {
-            objectArray = [
-                objectOne, objectTwo, objectThree, objectFour
-            ];
-            objectArrayLenOrig = objectArray.length;
-        });
-    }
-
-    /*describe("InsertElement()", () => {
-        setupBeforeEachNumberArr();
-
-        /!* Negative *!/
-
-        it("should return false when all undefined arguments were given", () => {
-            expect(ArrayUtils.InsertElement(undefined, undefined, undefined)).toBeFalsy();
-        });
-
-        it("should return false when undefined index was given", () => {
-            expect(ArrayUtils.InsertElement(undefined, 1, numberArray)).toBeFalsy();
-        });
-
-        it("should return false when undefined array was given", () => {
-            expect(ArrayUtils.InsertElement(0, 1, undefined)).toBeFalsy();
-        });
-
-        it("should return false when a positive out-of-bounds index was given", () => {
-            expect(ArrayUtils.InsertElement(undefined, 2 * numberArray.length, numberArray)).toBeFalsy();
-        });
-
-        it("should return false when a negative out-of-bounds index was given", () => {
-            expect(ArrayUtils.InsertElement(undefined, -2 * numberArray.length, numberArray)).toBeFalsy();
-        });
-
-        /!* Positive *!/
-
-        it("should succesfully insert an undefined element", () => {
-            expect(ArrayUtils.InsertElement(0, undefined, numberArray)).toBeTruthy();
-            expect(numberArray.length).toEqual(numberArrayLenOrig + 1);
-        });
-
-        it("should succesfully insert an numerical element", () => {
-            expect(ArrayUtils.InsertElement(0, 6, numberArray)).toBeTruthy();
-            expect(numberArray.length).toEqual(numberArrayLenOrig + 1);
-        });
-
-        it("should succesfully insert an element when given a negative index, and count from the end of the array for index", () => {
-            // when
-            ArrayUtils.InsertElement(-2, 6, numberArray);
-
-            // then
-            expect(numberArray[4]).toEqual(6, "inserted value wasn't there");
-            expect(numberArray.length).toEqual(numberArrayLenOrig + 1, "array length didn't change");
-        });
-    });*/
-
-    /*describe("RemoveElement()", () => {
-        setupBeforeEachNumberArr();
-
-        /!* Negative *!/
-
-        it("should return false when all undefined arguments were given", () => {
-            expect(ArrayUtils.RemoveElement(undefined, undefined)).toBeFalsy();
-        });
-
-        it("should return false when undefined element was given", () => {
-            expect(ArrayUtils.RemoveElement(undefined, numberArray)).toBeFalsy();
-        });
-
-        it("should return false when undefined array was given", () => {
-            expect(ArrayUtils.RemoveElement(1, undefined)).toBeFalsy();
-        });
-
-        it("should return false when a non-existing element was given", () => {
-            expect(ArrayUtils.RemoveElement(10, numberArray)).toBeFalsy();
-        });
-
-        /!* Positive *!/
-
-        it("should succesfully remove an existing element", () => {
-            // when
-            ArrayUtils.RemoveElement(0, numberArray);
-
-            // then
-            expect(numberArray[0]).not.toEqual(0, "removed value was still there");
-            expect(numberArray.length).toEqual(numberArrayLenOrig - 1, "array length didn't change");
-        });
-    });
-
-    describe("MoveElement()", () => {
-        setupBeforeEachNumberArr();
-
-        /!* Negative *!/
-
-        it("should return false when all undefined arguments were given", () => {
-            expect(ArrayUtils.MoveElement(undefined, undefined, undefined)).toBeFalsy();
-        });
-
-        it("should return false when undefined index was given", () => {
-            expect(ArrayUtils.MoveElement(undefined, 1, numberArray)).toBeFalsy();
-        });
-
-        it("should return false when undefined array was given", () => {
-            expect(ArrayUtils.MoveElement(0, 1, undefined)).toBeFalsy();
-        });
-
-        it("should return false when moving an element to the location it already resides at, since no true movement occurred", () => {
-            expect(ArrayUtils.MoveElement(0, 0, numberArray)).toBeFalsy();
-        });
-
-        /!* Positive *!/
-        it("should have really moved an element when normally moving an element", () => {
-            // when
-            let result: boolean = ArrayUtils.MoveElement(0, 1, numberArray);
-
-            // then
-            expect(result).toBeTruthy();
-            expect(numberArray[1]).toBe(0);
-        });
-
-        it("should accept a toIndex lower than 0, and correct the toIndex to 0", () => {
-            // when
-            let result: boolean = ArrayUtils.MoveElement(5, -1, numberArray);
-
-            // then
-            expect(result).toBeTruthy();
-            expect(numberArray[0]).toBe(5);
-        });
-
-        it("should not change the arrays length when given a toIndex lower than 0", () => {
-            // when
-            ArrayUtils.MoveElement(5, -1, numberArray);
-
-            // then
-            expect(numberArray.length).toBe(numberArrayLenOrig);
-        });
-
-        it("should accept a toIndex higher than array length, and use the last index nr of array", () => {
-            // when
-            let result: boolean = ArrayUtils.MoveElement(1, 10, numberArray);
-
-            // then
-            expect(result).toBeTruthy();
-            expect(numberArray[5]).toBe(1);
-        });
-
-        it("should not change the arrays length when given a toIndex higher than array length", () => {
-            // when
-            ArrayUtils.MoveElement(1, -10, numberArray);
-
-            // then
-            expect(numberArray.length).toBe(numberArrayLenOrig);
-        });
-    });*/
-
-    /*describe("SwapElements()", () => {
-        setupBeforeEachNumberArr();
-
-        /!* Negative *!/
-
-        it("should return false when all undefined arguments were given", () => {
-            expect(ArrayUtils.SwapElements(undefined, undefined, undefined)).toBeFalsy();
-        });
-
-        it("should return false when undefined from element was given", () => {
-            expect(ArrayUtils.SwapElements(undefined, 1, numberArray)).toBeFalsy();
-        });
-
-        it("should return false when undefined array was given", () => {
-            expect(ArrayUtils.SwapElements(0, 1, undefined)).toBeFalsy();
-        });
-
-        it("should return false when a non-existing elementOne was given", () => {
-            expect(ArrayUtils.SwapElements(99, 1, undefined)).toBeFalsy();
-        });
-
-        it("should return false when a non-existing elementTwo was given", () => {
-            expect(ArrayUtils.SwapElements(1, 99, undefined)).toBeFalsy();
-        });
-
-        /!* Positive *!/
-
-        it("should have really swapped an element when normally swapping an element", () => {
-            // when
-            let result: boolean = ArrayUtils.SwapElements(0, 1, numberArray);
-
-            // then
-            expect(result).toBeTruthy();
-            expect(numberArray[0]).toBe(1);
-        });
-
-        it("should not change the arrays length after a succesful swap", () => {
-            // when
-            ArrayUtils.SwapElements(0, 1, numberArray);
-
-            // then
-            expect(numberArray.length).toBe(numberArrayLenOrig);
-        });
-    });*/
-
-    /*describe("RemoveElementAtIndex()", () => {
-        setupBeforeEachNumberArr();
-
-        /!* Negative *!/
-
-        it("should return false when all undefined arguments were given", () => {
-            expect(ArrayUtils.RemoveElementAtIndex(undefined, undefined)).toBeFalsy();
-        });
-
-        it("should return false when undefined index was given", () => {
-            expect(ArrayUtils.RemoveElementAtIndex(undefined, numberArray)).toBeFalsy();
-        });
-
-        it("should return false when undefined array was given", () => {
-            expect(ArrayUtils.RemoveElementAtIndex(0, undefined)).toBeFalsy();
-        });
-
-        it("should return false when a non-existing index was given", () => {
-            expect(ArrayUtils.RemoveElementAtIndex(-1, numberArray)).toBeFalsy();
-        });
-
-        /!* Positive *!/
-
-        it("should have really removed an element when normally removing an element", () => {
-            // when
-            let result: boolean = ArrayUtils.RemoveElementAtIndex(0, numberArray);
-
-            // then
-            expect(result).toBeTruthy();
-            expect(numberArray[0]).not.toBe(0);
-        });
-
-        it("should have reduced the arrays length by one after a succesful removal", () => {
-            // when
-            ArrayUtils.RemoveElementAtIndex(0, numberArray);
-
-            // then
-            expect(numberArray.length).toBe(numberArrayLenOrig - 1);
-        });
-    });*/
-
-    /*describe("RemoveElementsByFilter()", () => {
-        setupBeforeEachNumberArr();
-
-        /!* Negative *!/
-
-        it("should return false when all undefined arguments were given", () => {
-            expect(ArrayUtils.RemoveElementsByFilter(undefined, undefined)).toBeFalsy();
-        });
-
-        it("should return false when undefined array was given", () => {
-            expect(ArrayUtils.RemoveElementsByFilter(undefined, () => { return true; })).toBeFalsy();
-        });
-
-        it("should return false when undefined filterFunction was given", () => {
-            expect(ArrayUtils.RemoveElementsByFilter(numberArray, undefined)).toBeFalsy();
-        });
-
-        it("should return false when filterFunction was given that never resolved to true (indication nothing was removed)", () => {
-            expect(ArrayUtils.RemoveElementsByFilter(numberArray, () => { return false; })).toBeFalsy();
-        });
-
-        /!* Positive *!/
-
-        it("should have really removed elements by filter when normally removing elements by filter", () => {
-            // when
-            let result: boolean = ArrayUtils.RemoveElementsByFilter(numberArray, (item: number) => {
-                return (item === 0 || item === 2);
-            });
-
-            // then
-            expect(result).toBeTruthy();
-            expect(numberArray.length).toBe(numberArrayLenOrig - 2);
-            expect(numberArray[0]).toEqual(1)
-        });
-    });*/
-
-    /*describe("ReplaceElement()", () => {
-        setupBeforeEachNumberArr();
-
-        /!* Negative *!/
-
-        it("shouldn't throw when all undefined arguments were given", () => {
-            // when
-            ArrayUtils.ReplaceElement(undefined, undefined, undefined);
-
-            // then
-            expect(true).toBeTruthy(); // no throws
-        });
-
-        it("shouldn't throw when undefined elementIn was given", () => {
-            // when
-            ArrayUtils.ReplaceElement(undefined, 2, numberArray);
-
-            // then
-            expect(true).toBeTruthy(); // no throws
-        });
-
-        it("shouldn't throw when undefined elementIn was given", () => {
-            // when
-            ArrayUtils.ReplaceElement(undefined, 1, numberArray);
-
-            // then
-            expect(true).toBeTruthy(); // no throws
-        });
-
-        it("shouldn't throw when undefined elementOut was given", () => {
-            // when
-            ArrayUtils.ReplaceElement(0, undefined, numberArray);
-
-            // then
-            expect(true).toBeTruthy(); // no throws
-        });
-
-        it("shouldn't throw when undefined array was given", () => {
-            // when
-            ArrayUtils.ReplaceElement(0, 1, undefined);
-
-            // then
-            expect(true).toBeTruthy(); // no throws
-        });
-
-        it("shouldn't throw when non-existing elementIn was given", () => {
-            // when
-            ArrayUtils.ReplaceElement(99, 1, numberArray);
-
-            // then
-            expect(true).toBeTruthy(); // no throws
-        });
-
-        it("shouldn't throw when non-existing elementOut was given", () => {
-            // when
-            ArrayUtils.ReplaceElement(1, 99, numberArray);
-
-            // then
-            expect(true).toBeTruthy(); // no throws
-        });
-
-        /!* Positive *!/
-
-        it("should have really replaced an element in the normal case", () => {
-            // when
-            ArrayUtils.ReplaceElement(99, 0, numberArray);
-
-            // then
-            expect(numberArray[0]).toEqual(99);
-            expect(numberArray.length).toBe(numberArrayLenOrig);
-        });
-    });*/
-
-
-    /*describe("PlaceElementRightOfOther()", () => {
-        setupBeforeEachObjectArr();
-
-        it("should move the element if it wasn't right of the other yet", () => {
-            // when
-            ArrayUtils.PlaceElementAfterOther(objectArray, objectOne, objectTwo);
-
-            // then
-            expect(objectArray[0]).toBe(objectTwo);
-        });
-
-        it("should work when wanting to place an item after the last array item", () => {
-            // when
-            ArrayUtils.PlaceElementAfterOther(objectArray, objectOne, objectFour);
-
-            // then
-            expect(objectArray[3]).toBe(objectOne);
-        });
-    });*/
-});
-
-
-
-
-// OLD BELOW
-describe('ArrayUtils', () => {
-    let one: any = 1;
-    let emptyNumberArray: number[] = [];
-    let letterArray: string[] = ["a", "b", "c", "d", "e"];
-    // Contents: [4: A, 5: B, 8: C, 10: D, 100000: E]
-    let sparseArray: string[] = [];
-    setupSparseArray();
-
-    /** [4: A, 5: B, 8: C, 10: D, 100000: E] */
-    function setupSparseArray(): void {
-        sparseArray[4] = "A";
-        sparseArray[5] = "B";
-        sparseArray[8] = "C";
-        sparseArray[10] = "D";
-        sparseArray[100000] = "E";
-    }
-
-    /*it("should remove the proper elements on RemoveElementsByFilter()", () => {
-        // given
-        let array: string[] = ["a", "b", "c", "d", "e"];
-
-        // when
-        ArrayUtils.RemoveElementsByFilter(array, (letter: string) => {
-            return letter === "a" || letter === "b";
-        });
-
-        // then
-        expect(array.length).toBe(3);
-    });
-
-    // InsertElement
-    it('InsertElement works', () => {
-        letterArray = ["a", "b", "c", "d", "e"];
-        expect(ArrayUtils.InsertElement(0, "0", letterArray) ).toBeTruthy(0);
-        expect(letterArray[0] === "0").toBeTruthy(1);
-        expect(ArrayUtils.InsertElement(999, "999", letterArray) === false).toBeTruthy(2);
-        expect(letterArray[999] === undefined).toBeTruthy(3);
-        letterArray = ["a", "b", "c", "d", "e"];
-        expect(ArrayUtils.InsertElement(5, "f", letterArray)).toBeTruthy(4);
-        expect(letterArray[5] === "f").toBeTruthy(5);
-    });
-
-    // RemoveElement
-    it('RemoveElement works', () => {
-        letterArray = ["a", "b", "c", "d", "e"];
-        expect(ArrayUtils.RemoveElement(undefined, letterArray) === false).toBeTruthy(0);
-        expect(letterArray.length === 5).toBeTruthy(1);
-        expect(ArrayUtils.RemoveElement(one, emptyNumberArray) === false).toBeTruthy(2);
-        expect(ArrayUtils.RemoveElement(1, emptyNumberArray) === false).toBeTruthy(3);
-        expect(ArrayUtils.RemoveElement("z", letterArray) === false).toBeTruthy(4);
-        expect(letterArray.length === 5).toBeTruthy(5);
-        expect(ArrayUtils.RemoveElement("a", letterArray)).toBeTruthy(6);
-        expect(letterArray.length === 4).toBeTruthy(7);
-        expect(ArrayUtils.RemoveElement("a", letterArray) === false).toBeTruthy(8);
-        expect(letterArray.length === 4).toBeTruthy(9);
-        expect(ArrayUtils.RemoveElement("e", letterArray)).toBeTruthy(10);
-        expect(letterArray.length === 3).toBeTruthy(11);
-    });
-
-    // RemoveElementAtIndex
-    it('RemoveElementAtIndex works', () => {
-        letterArray = ["a", "b", "c", "d", "e"];
-        expect(ArrayUtils.RemoveElementAtIndex(undefined, letterArray) === false).toBeTruthy(0);
-        expect(letterArray.length === 5).toBeTruthy(1);
-        expect(ArrayUtils.RemoveElementAtIndex(one, emptyNumberArray) === false).toBeTruthy(2);
-        expect(ArrayUtils.RemoveElementAtIndex(1, emptyNumberArray) === false).toBeTruthy(3);
-        expect(letterArray.length === 5).toBeTruthy(5);
-        expect(ArrayUtils.RemoveElementAtIndex(0, letterArray)).toBeTruthy(6);
-        expect(letterArray.length === 4).toBeTruthy(7);
-        expect(ArrayUtils.RemoveElementAtIndex(4, letterArray) === false).toBeTruthy(8);
-        expect(letterArray.length === 4).toBeTruthy(9);
-        expect(ArrayUtils.RemoveElementAtIndex(3, letterArray)).toBeTruthy(10);
-        expect(letterArray.length === 3).toBeTruthy(11);
-    });
-
-    // ContainsAnElementFoundBy
-    it('ContainsAnElementFoundBy handles faulty arguments correcly', () => {
-        expect(ArrayUtils.ContainsAnElementFoundBy(undefined, undefined) === false).toBeTruthy(0);
-        expect(ArrayUtils.ContainsAnElementFoundBy([], undefined) === false).toBeTruthy(1);
-    });
-
-    it('ContainsAnElementFoundBy handles valid arguments correcly', () => {
-        letterArray = ["a", "b", "c", "d", "e"];
-        let finderFunction: any = (element: string): boolean => {
-            return (element === "a");
-        };
-        expect(ArrayUtils.ContainsAnElementFoundBy(letterArray, finderFunction) ).toBeTruthy(1);
-        finderFunction = (element: string): boolean => {
-            return (element === "zzz");
-        };
-        expect(ArrayUtils.ContainsAnElementFoundBy(letterArray, finderFunction) === false).toBeTruthy(2);
-    });
-
-    // FillUntilLength
-    it('FillUntilLength handles faulty arguments correcly', () => {
-        letterArray = ["a", "b", "c", "d", "e"];
-        expect(ArrayUtils.FillUntilLength(undefined, undefined) === false).toBeTruthy(0);
-        expect(ArrayUtils.FillUntilLength(undefined, 1) === false).toBeTruthy(1);
-        expect(ArrayUtils.FillUntilLength(letterArray, undefined) === false).toBeTruthy(2);
-        expect(ArrayUtils.FillUntilLength(letterArray, -6) === false).toBeTruthy(3);
-        expect(ArrayUtils.FillUntilLength(letterArray, 0) === false).toBeTruthy(4);
-        expect(ArrayUtils.FillUntilLength(letterArray, 5) === false).toBeTruthy(5);
-        expect(letterArray.length === 5).toBeTruthy(6);
-    });
-
-    it('FillUntilLength handles valid arguments correcly', () => {
-        letterArray = ["a", "b", "c", "d", "e"];
-        expect(ArrayUtils.FillUntilLength(letterArray, 6)).toBeTruthy(0);
-        expect(letterArray.length === 6).toBeTruthy(1);
-        expect(ArrayUtils.FillUntilLength(letterArray, 7, "f")).toBeTruthy(2);
-        expect(letterArray.length === 7).toBeTruthy(3);
-        expect(letterArray[6] === "f").toBeTruthy(4);
-        expect(ArrayUtils.FillUntilLength(letterArray, 10)).toBeTruthy(5);
-        expect(letterArray.length === 10).toBeTruthy(6);
-    });
-
-    // GetNthElementInPossiblySparseArray
-    it('GetNthElementInPossiblySparseArray handles faulty arguments correcly', () => {
-        setupSparseArray();
-        expect(ArrayUtils.GetNthElementInPossiblySparseArray(sparseArray, -1.15) === undefined).toBeTruthy(0);
-        expect(ArrayUtils.GetNthElementInPossiblySparseArray(sparseArray, 0) === undefined).toBeTruthy(1);
-        expect(ArrayUtils.GetNthElementInPossiblySparseArray(sparseArray, 6) === undefined).toBeTruthy(2);
-        expect(ArrayUtils.GetNthElementInPossiblySparseArray(undefined, -1) === undefined).toBeTruthy(3);
-        expect(ArrayUtils.GetNthElementInPossiblySparseArray(undefined, 1) === undefined).toBeTruthy(4);
-    });
-
-    it('GetNthElementInPossiblySparseArray handles valid arguments correcly', () => {
-        setupSparseArray();
-        expect(ArrayUtils.GetNthElementInPossiblySparseArray(sparseArray, 1) === "A").toBeTruthy(0);
-        expect(ArrayUtils.GetNthElementInPossiblySparseArray(sparseArray, 2) === "B").toBeTruthy(1);
-        expect(ArrayUtils.GetNthElementInPossiblySparseArray(sparseArray, 3) === "C").toBeTruthy(2);
-        expect(ArrayUtils.GetNthElementInPossiblySparseArray(sparseArray, 4) === "D").toBeTruthy(3);
-        expect(ArrayUtils.GetNthElementInPossiblySparseArray(sparseArray, 5) === "E").toBeTruthy(4);
-    });
-
-    // GetNumberOfElementsInPossiblySparseArray
-    it('GetNumberOfElementsInPossiblySparseArray handles faulty arguments correcly', () => {
-        setupSparseArray();
-        expect(ArrayUtils.GetNumberOfElementsInPossiblySparseArray(undefined) === undefined).toBeTruthy();
-    });
-
-    it('GetNumberOfElementsInPossiblySparseArray handles valid arguments correcly', () => {
-        setupSparseArray();
-        expect(ArrayUtils.GetNumberOfElementsInPossiblySparseArray(sparseArray) === 5).toBeTruthy(0);
-        ArrayUtils.RemoveElement("B", sparseArray);
-        expect(ArrayUtils.GetNumberOfElementsInPossiblySparseArray(sparseArray) === 4).toBeTruthy(1);
-        sparseArray = [];
-        expect(ArrayUtils.GetNumberOfElementsInPossiblySparseArray(sparseArray) === 0).toBeTruthy(2);
-    });
-
-    it('SortAlphabetically handles valid arguments correctly', () => {
-        // works on array of strings
-        let arrWithStrings: string[] = ["bee", "dee", "cee", "aaa"];
-        ArrayUtils.SortAlphabetically(arrWithStrings);
-        expect(arrWithStrings[0] === "aaa").toBeTruthy(1);
-        expect(arrWithStrings[1] === "bee").toBeTruthy(2);
-        expect(arrWithStrings[2] === "cee").toBeTruthy(3);
-        expect(arrWithStrings[3] === "dee").toBeTruthy(4);
-        // works on array of objects
-        class A {
-            txt: string;
-        }
-        let arr: A[] = [];
-        for (let i: number = 0; i < 26; i++) {
-            let randomAlphabetNr: number = NumberUtils.RandomInt(0, 25);
-            let randomChar: string = String.fromCharCode(97 + randomAlphabetNr);
-            let a: A = new A();
-            a.txt = randomChar.concat(randomChar).concat(randomChar);
-            arr.push(a);
-        }
-        ArrayUtils.SortAlphabetically(arr, "txt");
-        expectArrayIsSortedAlphabetically(arr, "txt");
-        ArrayUtils.SortAlphabetically(arr, "txt", true);
-        expectArrayIsSortedAlphabetically(arr, "txt", true);
-    });*/
-
-    // expectation helper for array sort-state check
-    function expectArrayIsSortedAlphabetically(arr: any[], property: string, reverse: boolean = false): void {
-        // for each element i, check whether property [i] <= [i + 1]
-        for (let i: number = 0, len: number = arr.length; i < len - 1; i++) {
-            if (!reverse) {
-                expect(arr[i][property] <= arr[i + 1][property]).toBeTruthy(i);
-            } else {
-                expect(arr[i][property] >= arr[i + 1][property]).toBeTruthy(i);
-            }
-        }
-    }
-});