@writetome51/is-match

A substitute for using === operator. Useful when arrays don't have to be identical via === to be deemed a match. They must only have identical content.

Usage no npm install needed!

<script type="module">
  import writetome51IsMatch from 'https://cdn.skypack.dev/@writetome51/is-match';
</script>

README

isMatch(
     item1: any,
     item2: any
): boolean

Works for any data type, but really intended for array comparison.
The algorithm:

function isMatch(item1, item2) {
    if (item1 === item2) return true;

    if (isArray(item1) && isArray(item2) && (item1.length === item2.length)) {

        for (let i = 0, length = item1.length; i < length; ++i) {
            if (not(isMatch( item1[i], item2[i] ))) return false;
        }
        return true;
    }
    else return false;
}

Examples

isMatch([], []); // true

isMatch(['a', 'b'],  ['a', 'b']); // true

isMatch(['a', 'b'],  ['a', 'b', 'c']); // false

// Elements must be in matching order to match:
isMatch(['a', 'b', 'c'],  ['c', 'b', 'a']); // false

isMatch([1, 2, [3]], [1, 2, [3]]); // true

let obj = {prop: 1};
isMatch([obj], [{prop:1}]); // false

let obj2 = obj;
isMatch([obj], [obj2]); // true


// Behaves the same as === operator for primitive types and non-array objects:

isMatch('', ''); // true

isMatch('0', '0'); // true

isMatch('0', 0); // false

isMatch('00', '01'); // false

isMatch(Infinity, Infinity); // true

isMatch(undefined, undefined); // true

let obj = {prop: 1};
isMatch(obj, {prop:1}); // false

let obj2 = obj;
isMatch(obj, obj2); // true

Installation

npm i @writetome51/is-match

Loading

import {isMatch} from '@writetome51/is-match';