A diff library for deep diff js/json object/array.

With 🚀 very fast diff speed (especially in array diff), 📦 tiny size (< 500b), 0 dependents, typescript support.

[English / 中文]

✨ Features

• 🚀 Faster then other object diff libs, and the amazing array diff speed
• 🛡 Build with typescript, fully support types
• 🌐 Support all special type object deep diff
• 📦 Lightweight and tree shaking support
• 🌎 Support web, Node and workers

🎬 Quick start

1. Install

npm i turbo-diff

2. Usage

Import the lib and call with your objects you want to do diff.

import diff from 'turbo-diff';

console.log(diff({ foo: 'bar' }, { foo: 'bar', newKey: 'value' }));

🪞 Interface

Generic support.

interface Diff<T = any> {
    type: 'ADD' | 'REMOVE' | 'CHANGE';
    path: (string | number)[];
    old?: T;
    new?: T;
}
declare const diff: <T = any, TObj = Record<string, T> | T[]>(oldObj: TObj, newObj: TObj) => Diff<any>[];

😼 Playground

🚀 Benchmark

• With small object

| "name" | "ops" | "margin" | "percentSlower" | | ----------------------------- | ------- | -------- | --------------- | | "diff" | 56562 | 0.56 | 98.88 | | "deep-diff" | 433694 | 0.31 | 91.4 | | "deep-object-diff" | 1149395 | 0.35 | 77.2 | | "jsdiff" | 57685 | 0.36 | 98.86 | | "microdiff" | 4400020 | 0.4 | 12.73 | | "microdiff-without-cyclesFix" | 4382206 | 0.39 | 13.08 | | "turbo-diff" | 5041725 | 3.06 | 0 |

• With big object

| "name" | "ops" | "margin" | "percentSlower" | | ----------------------------- | --------- | -------- | --------------- | | "diff" | 0.09 | 2.27 | 100 | | "deep-diff" | 3911.885 | 0.3 | 88.24 | | "deep-object-diff" | 35.305 | 0.31 | 99.89 | | "jsdiff" | 0.089 | 0.53 | 100 | | "microdiff" | 28992.708 | 0.51 | 12.82 | | "microdiff-without-cyclesFix" | 29038.595 | 0.35 | 12.68 | | "turbo-diff" | 33256.928 | 0.4 | 0 |

• With big object(deep 4, property count 10)

| "name" | "ops" | "margin" | "percentSlower" | | ----------------------------- | --------- | -------- | --------------- | | "diff" | 0.0201 | 1.32 | 100 | | "deep-diff" | 364.4773 | 0.4 | 68.82 | | "deep-object-diff" | 360.8354 | 0.46 | 69.13 | | "jsdiff" | 0.02 | 2.02 | 100 | | "microdiff" | 902.0445 | 0.38 | 22.84 | | "microdiff-without-cyclesFix" | 1021.0441 | 0.33 | 12.66 | | "turbo-diff" | 1169.0366 | 0.33 | 0 |

• With deeply nested object

| "name" | "ops" | "margin" | "percentSlower" | | ----------------------------- | ------ | -------- | --------------- | | "diff" | 9192 | 0.35 | 99.03 | | "deep-diff" | 163921 | 0.28 | 82.79 | | "deep-object-diff" | 330296 | 0.41 | 65.32 | | "jsdiff" | 9050 | 0.32 | 99.05 | | "microdiff" | 644867 | 0.35 | 32.3 | | "microdiff-without-cyclesFix" | 817169 | 0.47 | 14.21 | | "turbo-diff" | 952516 | 0.3 | 0 |

• With simple array

| "name" | "ops" | "margin" | "percentSlower" | | ----------------------------- | ------- | -------- | --------------- | | "diff" | 37656 | 0.37 | 98.71 | | "deep-diff" | 337257 | 0.36 | 88.43 | | "deep-object-diff" | 278428 | 0.39 | 90.44 | | "jsdiff" | 38266 | 0.28 | 98.69 | | "microdiff" | 1610910 | 0.44 | 44.71 | | "microdiff-without-cyclesFix" | 1585105 | 0.38 | 45.6 | | "turbo-diff" | 2913708 | 0.37 | 0 |

• With simple array(place short array as newObject)

| "name" | "ops" | "margin" | "percentSlower" | | ----------------------------- | ------- | -------- | --------------- | | "diff" | 38656 | 0.31 | 98.54 | | "deep-diff" | 340188 | 0.81 | 87.15 | | "deep-object-diff" | 289963 | 0.34 | 89.05 | | "jsdiff" | 39385 | 0.93 | 98.51 | | "microdiff" | 1784744 | 0.48 | 32.58 | | "microdiff-without-cyclesFix" | 1786782 | 0.31 | 32.51 | | "turbo-diff" | 2647332 | 0.37 | 0 |