Benchmark: lodash vs fast-equals vs fast-deep-equal

HTML Preparation code:

<script src="https://cdn.jsdelivr.net/npm/lodash@4.17.20/lodash.min.js"></script>

<script src="https://unpkg.com/fast-equals@5.0.1/dist/min/index.js"></script>

Script Preparation code:

function equal(a, b) {
  if (a === b) return true;

  if (a && b && typeof a == 'object' && typeof b == 'object') {
    if (a.constructor !== b.constructor) return false;

    var length, i, keys;
    if (Array.isArray(a)) {
      length = a.length;
      if (length != b.length) return false;
      for (i = length; i-- !== 0;)
        if (!equal(a[i], b[i])) return false;
      return true;
    }



    if (a.constructor === RegExp) return a.source === b.source && a.flags === b.flags;
    if (a.valueOf !== Object.prototype.valueOf) return a.valueOf() === b.valueOf();
    if (a.toString !== Object.prototype.toString) return a.toString() === b.toString();

    keys = Object.keys(a);
    length = keys.length;
    if (length !== Object.keys(b).length) return false;

    for (i = length; i-- !== 0;)
      if (!Object.prototype.hasOwnProperty.call(b, keys[i])) return false;

    for (i = length; i-- !== 0;) {
      var key = keys[i];

      if (!equal(a[key], b[key])) return false;
    }

    return true;
  }

  // true if both NaN, false otherwise
  return a!==a && b!==b;
};

// 1 level deep
var data = [
                    {
                        description: 'equal numbers',
                        value1: 1,
                        value2: 1,
                        equal: true,
                    },
                    {
                        description: 'not equal numbers',
                        value1: 1,
                        value2: 2,
                        equal: false,
                    },
                    {
                        description: 'number and array are not equal',
                        value1: 1,
                        value2: [],
                        equal: false,
                    },
                    {
                        description: '0 and null are not equal',
                        value1: 0,
                        value2: null,
                        equal: false,
                    },
                    {
                        description: 'equal strings',
                        value1: 'a',
                        value2: 'a',
                        equal: true,
                    },
                    {
                        description: 'big object',
                        value1: {
                            prop1: 'value1',
                            prop2: 'value2',
                            prop3: 'value3',
                            prop4: {
                                subProp1: 'sub value1',
                                subProp2: {
                                    subSubProp1: 'sub sub value1',
                                    subSubProp2: [
                                        1,
                                        2,
                                        { prop2: 1, prop: 2 },
                                        4,
                                        5,
                                    ],
                                },
                            },
                            prop5: 1000,
                            prop6: new Date(2016, 2, 10),
                        },
                        value2: {
                            prop5: 1000,
                            prop3: 'value3',
                            prop1: 'value1',
                            prop2: 'value2',
                            prop6: new Date('2016/03/10'),
                            prop4: {
                                subProp2: {
                                    subSubProp1: 'sub sub value1',
                                    subSubProp2: [
                                        1,
                                        2,
                                        { prop2: 1, prop: 2 },
                                        4,
                                        5,
                                    ],
                                },
                                subProp1: 'sub value1',
                            },
                        },
                        equal: true,
                    },
                ];

Tests:

lodash
data.forEach((item) => { _.isEqual(item.value1, item.value2); });
fast-deep-equal
data.forEach((item) => { equal(item.value1, item.value2); });
fast-equals
data.forEach((item) => { window['fast-equals'].deepEqual(item.value1, item.value2); });

Historical Performance Data aggregated from 34 community runs

Desktop Results:

Chrome 29 runs

fast-equals

2.4M/s

fast-deep-equal

2.3M/s

lodash

638K/s

Fastest: fast-equals (3.8x faster)

View exact numbers

✓ fast-equals: 2,432,699 ops/sec
• fast-deep-equal: 2,256,850 ops/sec
• lodash: 637,547 ops/sec

Firefox 5 runs

fast-deep-equal

1.6M/s

fast-equals

723K/s

lodash

263K/s

Fastest: fast-deep-equal (6.1x faster)

View exact numbers

✓ fast-deep-equal: 1,599,203 ops/sec
• fast-equals: 722,799 ops/sec
• lodash: 263,234 ops/sec

Results show median performance across all community submissions. Run this benchmark yourself to verify on your device.

Rendered benchmark preparation results:

Suite status: <idle, ready to run>

Previous results

Test case name	Result
lodash
fast-deep-equal
fast-equals

Fastest: N/A

Slowest: N/A

Latest run results:

Run details: (Test run date: 20 days ago)

User agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36

Browser/OS: Chrome 150 on Mac OS X 10.15.7

View result in a separate tab

fast-equals

2.4M/s

fast-deep-equal

2.3M/s

lodash

638K/s

View exact numbers

Test name	Executions per second
✓ fast-equals	2,410,734 Ops/sec
fast-deep-equal	2,270,492 Ops/sec
lodash	637,547 Ops/sec

Autogenerated LLM Summary (model llama3.2:3b, generated one year ago):

LLMs can make mistakes. Check important info.

I'll provide an in-depth explanation of the benchmark, its options, pros and cons, and other considerations.

**Benchmark Overview**

The benchmark is designed to compare the performance of three equality-checking libraries: Lodash's `isEqual`, Fast-Equals' `deepEqual`, and another implementation (Fast-Deep-Equal) that is not widely used. The test cases involve iterating over an array of objects with nested properties, comparing corresponding values using each library.

**Library Options**

1. **Lodash (`isEqual`)**: Lodash is a popular utility library that provides a wide range of functions for various tasks, including equality checking.
	* Pros:
		+ Robust feature set
		+ Well-documented and widely adopted
	* Cons:
		+ Larger bundle size compared to other libraries
2. **Fast-Equals (`deepEqual`)**: Fast-Equals is a lightweight library specifically designed for deep equality checks.
	* Pros:
		+ Small bundle size (≈10KB)
		+ Optimized for performance
3. **Fast-Deep-Equal**: This implementation is not widely used and is included in the benchmark for comparison purposes.

**Pros and Cons of Each Approach**

1. **Lodash (`isEqual`)**:
	* Pros: Robust feature set, well-documented.
	* Cons: Larger bundle size, may be overkill for simple equality checks.
2. **Fast-Equals (`deepEqual`)**:
	* Pros: Small bundle size, optimized for performance.
	* Cons: Limited feature set compared to Lodash.
3. **Fast-Deep-Equal**:
	* Pros: None notable.
	* Cons: Not widely used and not well-documented.

**Other Considerations**

1. **Test Cases**: The benchmark includes three test cases that cover different aspects of equality checking, including shallow and deep comparisons.
2. **Device Platforms**: The benchmark results are reported for Chrome 118 on Windows Desktop platforms.
3. **Results Interpretation**: The benchmark results indicate the number of executions per second (ExecutionsPerSecond) for each library.

**Recommendations**

Based on the benchmark results, Fast-Equals appears to be the fastest and most efficient option for equality checks in this scenario. However, Lodash's robust feature set and well-documented API make it a popular choice among developers. If performance is critical, using a lightweight library like Fast-Equals might be a better option.

lodash vs fast-equals vs fast-deep-equal (version: 0)

Comparing performance of: `lodash vs fast-deep-equal vs fast-equals`

Created: 2 years ago by: Registered User

Go to the latest result

lodash

fast-deep-equal

fast-equals

Historical Performance Data aggregated from 34 community runs

Desktop Results:

Chrome 29 runs

Firefox 5 runs

Suite status: <idle, ready to run>

Fastest: N/A

Slowest: N/A

Autogenerated LLM Summary (model llama3.2:3b, generated one year ago):

lodash vs fast-equals vs fast-deep-equal (version: 0)

Comparing performance of: lodash vs fast-deep-equal vs fast-equals

Created: 2 years ago by: Registered User

Go to the latest result

lodash

fast-deep-equal

fast-equals

Historical Performance Data aggregated from 34 community runs

Desktop Results:

Chrome 29 runs

Firefox 5 runs

Suite status: <idle, ready to run>

Fastest: N/A

Slowest: N/A

Autogenerated LLM Summary (model llama3.2:3b, generated one year ago):

Related benchmarks

Comparing performance of: `lodash vs fast-deep-equal vs fast-equals`