ESM and TypeScript rewrite of Google's diff-match-patch (for JavaScript).
- Rewritten in ESM and TypeScript, ships with type declarations
- Published as dual ESM/CJS formats
- Refactor all to pure functions, fully tree-shakable
Migration from diff-match-patch
npm package
- Default export and the class constructor has been removed
- Function name has been unified to camelCase
- Previous options like
Diff_Timeout
andDiff_EditCost
are now passed as an options object in the arguments if needed
// before
import DiffMatchPatch from 'diff-match-patch'
const dmp = new DiffMatchPatch()
dmp.Diff_Timeout = 1
const result = dmp.diff_main('hello', 'world')
// after
import { diff } from 'diff-match-patch-es'
const result = diff('hello', 'world', { diffTimeout: 1 })
Well, the code source repo from Google hasn't been updated for 5 years, and the npm package diff-match-patch
hasn't been published for 4 years. And the code is not ESM nor tree-shakable. While this library is a composition of diff
patch
and match
functions, sometimes you don't need all of them but since all functions were bound to a single class, all the code has to be included in the bundle. It's probably not a big deal as this whole library is still relatively small, but it's a bit annoying to me when you know something wasn't optimal. So I took an afternoon porting and rewriting the library to ESM and TypeScript. Helpfully it will lead to better maintainability and help the community to move forward with the modern JavaScript ecosystem.
Apache-2.0 License