@newdash/newdash/functional/toHashCode.js

javascript/typescript utility library

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.toHashCode = void 0;
const md5_1 = require("../md5");
const ARRAY_NOT_OBJECT_TYPES = ["number", "string", "bigint", "symbol", "function"];
const CONST_S_UNDEFINED = "undefined";
const CONST_S_NULL = "null";
const CONST_S_OBJECT = "object";
function stringSort(a, b) {
    return String(a).localeCompare(String(b));
}
/**
 * Object.toHashCode
 *
 * remember: the **SAME** structure object will return the **SAME** hash code
 *
 * @category Functional
 * @since 5.15.0
 * @param obj anything in js
 *
 * @returns the hash of the object (string(32))
 *
 * ```ts
    const a1 = [1, 2, 3, 4];
    const a2 = [1, 2, 3, 4];

    expect(toHashCode(a1)).toBe(toHashCode(a2));

    const o1 = { a: 1 };
    const o2 = { a: 1 };
    const o3 = { a: 2 };

    expect(toHashCode(o1)).toBe(toHashCode(o2));
    expect(toHashCode(o1)).not.toBe(toHashCode(o3));

    expect(toHashCode('simple')).toBe(toHashCode('simple'));
    expect(toHashCode('11')).not.toBe(toHashCode(11));
 * ```
 */
function toHashCode(obj) {
    const objType = typeof obj;
    if (obj === undefined) {
        return (0, md5_1.md5)(CONST_S_UNDEFINED);
    }
    else if (obj === null) {
        return (0, md5_1.md5)(CONST_S_NULL);
    }
    else if (obj instanceof Array) {
        return (0, md5_1.md5)(obj.map(toHashCode).join());
    }
    else if (obj instanceof Set) {
        return toHashCode(Array.from(obj.values()).sort(stringSort));
    }
    else if (obj instanceof Map) {
        return toHashCode(Array
            .from(obj.keys())
            .sort(stringSort)
            .map((key) => `${String(key)}_${toHashCode(obj.get(key))}`));
    }
    else if (objType === CONST_S_OBJECT) {
        return toHashCode(Object
            .keys(obj)
            .sort(stringSort) // order by keys
            .map((key) => `${String(key)}_${toHashCode(obj[key])}`));
    }
    else if (ARRAY_NOT_OBJECT_TYPES.includes(objType)) {
        return (0, md5_1.md5)(`${objType}_${String(obj)}`);
    }
    throw new TypeError(`un-expected object type ${objType}, please consider report this issue to 'newdash' team`);
}
exports.toHashCode = toHashCode;
exports.default = toHashCode;