0.18.0
This release is one of the biggest, most feature-packed release we’ve had in a long time. We have prepared lots of tasty things for you - snapshot testing, magic assert, precompiling test helpers, improvements to Babel transpilation, and more. Our team and contributors have been working hard to deliver all this goodness. We can’t wait to hear your feedback and don’t hesitate to suggest new ideas and report bugs!
Highlights
Dropped support for Node.js 0.10 and 0.12
As mentioned in the 0.17.0 release notes, we’re dropping support for Node.js 0.10 and 0.12 in this release. They’re both out of maintenance mode. Time to upgrade!
Magic assert
We completely overhauled the error output to make it as easy and fast as possible to detect the source of the failure. Magic assert, as we call it internally, adds code excerpts and clean diffs for actual and expected values. If values in the assertion are objects or arrays, only a difference is displayed to remove the noise and focus on the problem. Oh, and the diff is syntax-highlighted too! If you are comparing strings, both single and multi line, AVA displays a different kind of output, highlighting the added or missing characters. Last but not least, you don’t have to update any of your tests to take advantage of this! Third-party assertion libraries, like expect, chai and others, are supported out-of-the-box as well.
Snapshot testing
We now have snapshot testing, thanks to @lithin ✨
Snapshot testing simply saves a stringified state of some data structure and compares it on the next run. It was popularized with React component testing, but you can use it with anything that can be stringified. For example, ensuring API responses stay the same.
ee65b6d
Precompile helper files
Previously, AVA transpiled your test files, but not your test helpers. Now we transpile helper files too! Helpers are files starting with _
or any files in a helpers
directory inside the test directory. These are usually used for utilities and shared logic between test files.
410cb8d
Improving language support
We’ve come up with a specification for how AVA handles Babel projects and may better support other languages like TypeScript. Customizing transpilation of test and helper files will be easier, and AVA will start transpiling source files too. We’ve started work on this, but there are no user-facing changes yet.
076eb81
Miscellaneous
- Removed deprecated assertions (
t.ok
,t.notOk
,t.same
,t.notSame
). If you haven’t migrated yet, you can do so automagically with our codemod. c010fd7 - Removed the
--source
flag. Use the package.json config instead. 34bebc4 - Support symlinked test files. 033d4dc
- No longer using
babel-runtime
. Built-ins likeMap
andPromise
are no longer replaced with polyfills. ad5122d - Prints a warning when
test.only()
is used, so you don’t mistakenly think you’re running all the tests. 22a6081 - Prints a warning when
--fail-fast
is enabled, so you’re aware AVA didn’t run all your tests. 09d23f5 - Exits with an error when
--watch
is used in CI, as otherwise the process would never exit, since watch mode is persistent. 0606ff7 - Only transpile what’s needed on Node.js 6. We already did that for Node.js 4. 5158ac8
- Flow type definition improvements: ce42fcb 314f7a0
- TypeScript type definition improvement: 0603edc
All changes
Thanks
💖 Huge thanks to @lithin, @ThomasBem, @leebyron, @rnkdev, @sebald, @gconaty, @jarlehansen, @LasaleFamine, @asafigan, for helping us with this release. We couldn’t have done it without you!
Get involved
We welcome new contributors. AVA is a friendly place to get started in open source. We have a great article on getting started contributing and a comprehensive contributing guide.