isEqual

The isEqual utility function performs a deep equality check between two values. It compares primitive values, arrays, and objects recursively to determine if they are structurally equal, regardless of reference equality.

Examples

Example 1: Basic Usage

Compare various types of values for deep equality:

import {isEqual} from 'ngx-lift';

console.log(isEqual(1, 1)); // true
console.log(isEqual(1, 2)); // false
console.log(isEqual('1', '1')); // true
console.log(isEqual('1', 1)); // false
console.log(isEqual([1], [1])); // true
console.log(isEqual([1], [2])); // false

Example 2: Deep Object Comparison

Compare nested objects and arrays:

import {isEqual} from 'ngx-lift';

// Deep object comparison
console.log(isEqual({a: 1, b: {c: 2}}, {a: 1, b: {c: 2}})); // true
console.log(isEqual({a: 1, b: {c: 2}}, {a: 1, b: {c: 3}})); // false

// Deep array comparison
console.log(isEqual([1, [2, 3]], [1, [2, 3]])); // true
console.log(isEqual([1, [2, 3]], [1, [2, 4]])); // false

API Reference

isEqual

Performs a deep equality check between two values.

Signature

isEqual(value1: unknown, value2: unknown): boolean

Parameters

  • value1: unknown

    The first value to compare.

  • value2: unknown

    The second value to compare.

Returns

true if the values are deeply equal, false otherwise. Performs recursive comparison for objects and arrays.