Superdiff provides a complete and readable diff for both arrays and objects. Plus, it supports stream and file inputs for handling large datasets efficiently, is battle-tested, has zero dependencies, and is super fast.

array-comparison comparison comparison-tool deep-diff diff json-diff nodejs object-comparison object-diff objectdiff objectdifference react streaming streaming-data typescript

2.9 KiB

Raw Blame History

DATA DIFF

This library compares two arrays or objects and return a complete diff of their differences.

Object exemple:

getObjectDiff() checks base properties but also provides a complete diff of nested properties.

Input

getObjectDiff(
  {
    id: 54,
    user: {
      name: "joe",
      member: true,
      hobbies: ["golf", "football"],
      age: 66,
    },
  },
  {
    id: 54,
    user: {
      name: "joe",
      member: false,
      hobbies: ["golf", "chess"],
      age: 66,
    },
  }
);

Output

{
      type: "object",
      status: "updated",
      diff: [
        {
          property: "id",
          previousValue: 54,
          currentValue: 54,
          status: "equal",
        },
        {
          property: "user",
          previousValue: {
            name: "joe",
            member: true,
            hobbies: ["golf", "football"],
            age: 66,
          },
          currentValue: {
            name: "joe",
            member: false,
            hobbies: ["golf", "chess"],
            age: 66,
          },
          status: "updated",
          subPropertiesDiff: [
            {
              name: "name",
              previousValue: "joe",
              currentValue: "joe",
              status: "equal",
            },
            {
              name: "member",
              previousValue: true,
              currentValue: false,
              status: "updated",
            },
            {
              name: "hobbies",
              previousValue: ["golf", "football"],
              currentValue: ["golf", "chess"],
              status: "updated",
            },
            {
              name: "age",
              previousValue: 66,
              currentValue: 66,
              status: "equal",
            },
          ],
        },
      ],
    }

List exemple:

getListDiff() works with arrays of string, number and objects. It doesn't work yet with duplicated values.