Adds expectations to chai which compare strings or objects using diff.
npm install chai-diff#chai-diff
Adds expectations to chai which compare strings or objects using jsdiff.
``javascript`
expect(value).differentFrom(another, options)
expect(value).not.differentFrom(another, options)
expect(value).to.be.differentFrom(another, options)
expect(value).not.to.be.differentFrom(another, options)
This will compare two strings or convert two objects to JSON strings and then compare them. One oddity is that the base form expects the objects to be different and you will generally use the .not.differentFrom form.
The options object is optional and can have the following options:
* showSpace [false] Whether to convert whitespace to visible Unicode characters in output.relaxedSpace [false]
* Whether to normalise whitespace before comparing strings. This:context [10]
- removes all leading whitespace
- removes all trailing whitespace
- replaces all sequences of whitespace with a single space
- removes any empty lines
* How many lines of context to show on each side of a difference
`bash`
npm install chai-diff --save-dev
In your specs, add:
`javascript`
chai.use(require('chai-diff'));
See chai-diff.spec.js for an example
Download the chai-diff.js file and add it to your main. Then in your test do something like:
`javascript
define(['chai', 'chai-diff', ...], function(chai, chaiDiff, ...) {
chai.use(chaiDiff);
describe(...);
});
`
Finally, if neither CommonJS nor AMD is detected, a global varialbe chaiDiff is created and can be used with:
`html`
See test.html` for an example
This is useful if:
* You need to ignore whitespace in string comparisons
* Your test runner doesn't show useful differences on failures.
Further improvements:
* More options for which whitespace to ignore