@types/diff

What is @types/diff?

The @types/diff package provides TypeScript type definitions for the 'diff' npm package, which is a utility for calculating differences between strings or arrays. These type definitions enable TypeScript developers to use the 'diff' library in a type-safe manner, ensuring that the inputs and outputs to the functions are correctly typed according to the expected operations of the 'diff' library.

What are @types/diff's main functionalities?

String Difference

Calculates and returns the differences between two strings character by character. The result is an array of change objects indicating parts that have been added or removed to transform the first string into the second.

import * as Diff from 'diff';

const diffResult = Diff.diffChars('old string', 'new string');
console.log(diffResult);

Array Difference

Compares two arrays and returns the differences. Useful for understanding changes between versions of list data, such as words or items in an inventory.

import * as Diff from 'diff';

const diffResult = Diff.diffArrays(['apple', 'orange'], ['apple', 'banana']);
console.log(diffResult);

Line Difference

Calculates the differences between two blocks of text line by line. This is particularly useful for comparing text files or output from different versions of a program.

import * as Diff from 'diff';

const diffResult = Diff.diffLines('line1\nline2', 'line1\nline3');
console.log(diffResult);

Other packages similar to @types/diff

jsdiff

jsdiff is the underlying JavaScript library that the 'diff' package wraps. It provides the same functionality but without TypeScript type definitions. Users of plain JavaScript might prefer this package.

google-diff-match-patch

This package offers a robust algorithm for plain text diffing, matching, and patching. It is more complex and feature-rich compared to 'diff', providing additional functionalities like patch creation and application, which are not directly available in 'diff'.

README

Installation

npm install --save @types/diff

Summary

This package contains type definitions for diff (https://github.com/kpdecker/jsdiff).

Details

Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/diff.

Additional Details

• Last updated: Tue, 07 Jan 2025 13:35:32 GMT
• Dependencies: none

Credits

These definitions were written by vvakame, szdc, BendingBender, and Piotr Błażejewicz.