Getting Started

📦

Installation

Install JSDiff via npm:

npm install diff

Or using yarn:

yarn add diff
📝

Basic Usage

Import the library and start comparing:

import * as Diff from 'diff';

const text1 = 'Hello world';
const text2 = 'Hello there';

const diff = Diff.diffChars(text1, text2);

diff.forEach((part) => {
  const color = part.added ? 'green' : 
                part.removed ? 'red' : 'grey';
  process.stdout.write(part.value[color]);
});

console.log();
🔧

Diff Types

JSDiff supports multiple comparison modes:

  • diffChars - Character-level comparison
  • diffWords - Word-level comparison (ignores whitespace)
  • diffLines - Line-level comparison
  • diffJson - JSON object comparison
// Character diff
const charDiff = Diff.diffChars('abc', 'aXc');

// Word diff
const wordDiff = Diff.diffWords('Hello world', 'Hello there');

// Line diff
const lineDiff = Diff.diffLines('line1\nline2', 'line1\nline3');

// JSON diff
const jsonDiff = Diff.diffJson({a: 1}, {a: 2});
✅

Next Steps