jest-diff

What is jest-diff?

The jest-diff npm package is a utility primarily used to show differences between two values, typically used in testing environments to assert the equality of objects, arrays, or other data structures. It is part of the Jest testing framework but can be used independently for its diffing capabilities.

What are jest-diff's main functionalities?

Diffing two values

This feature allows you to compare two JavaScript objects and outputs a string that visually represents the differences between them. It is useful for debugging and in test assertions to see what exactly differs when a test fails.

const diff = require('jest-diff');
const a = { a: { b: { c: 5 } } };
const b = { a: { b: { c: 6 } } };
console.log(diff(a, b));

Customizing diff output

This feature allows customization of the diff output by passing options. You can specify annotations for the compared values, which helps in making the output more understandable and tailored to specific needs.

const diff = require('jest-diff');
const options = { aAnnotation: 'First', bAnnotation: 'Second' };
const a = [1, 2, 3];
const b = [2, 1, 3];
console.log(diff(a, b, options));

Other packages similar to jest-diff

deep-diff

Deep-diff is a library that provides a detailed analysis of differences between any two JavaScript objects. It is more granular than jest-diff as it provides more detailed information about the type of change (edit, delete, add), which can be useful for more complex diffing needs.

diff

The 'diff' package is another popular choice for computing differences between texts. It is not limited to JavaScript objects and can handle strings effectively, making it suitable for applications like text editors or any scenario where text comparison is needed. Unlike jest-diff, it does not provide a structured view for object differences.

README

The README file is missing

Changelog

jest 15.0.0

• See https://jestjs.io/blog/2016/09/01/jest-15
• Jest by default now also recognizes files ending in .spec.js and .test.js as test files.
• Completely replaced most Jasmine matchers with new Jest matchers.
• Rewrote Jest's CLI output for test failures and summaries.
• Added --env option to override the default test environment.
• Disabled automocking, fake timers and resetting the module registry by default.
• Added --watchAll, made --watch interactive and added the ability to update snapshots and select test patterns in watch mode.
• Jest uses verbose mode when running a single test file.
• Console messages are now buffered and printed along with the test results.
• Fix testEnvironment resolution to prefer jest-environment-{name} instead of {name} only. This prevents a module collision when using jsdom as test environment.
• moduleNameMapper now uses a resolution algorithm.
• Improved performance for small test runs.
• Improved API documentation.
• Jest now works properly with directories that have special characters in them.
• Improvements to Jest's own test infra by merging integration and unit tests. Code coverage is now collected for Jest.
• Added global.global to the node environment.
• Fixed babel-jest-plugin-hoist issues with functions called mock.
• Improved jest-react-native preset with mocks for ListView, TextInput, ActivityIndicator and ScrollView.
• Added collectCoverageFrom to collect code coverage from untested files.
• Rewritten code coverage support.