If you want to skip all the news and just get going, run npm install jest@^30.0.0 and follow the migration guide: Upgrading from Jest 29 to 30.

What’s New?​

Jest 30 is noticeably faster, uses less memory, and comes with tons of new features. First, let’s take a look at the breaking changes:

Важливі Зміни​

• Jest 30 drops support for Node 14, 16, 19, and 21.
• jest-environment-jsdom was upgraded from jsdom 21 to 26.
• The minimum compatible TypeScript version is now 5.4.
• Various expect aliases were removed. eslint-plugin-jest has an autofixer which you can run to automatically upgrade your codebase.
• Non-enumerable object properties are now excluded from object matchers such as toEqual by default.
• Jest now supports .mts and .cts files by default.
• --testPathPattern was renamed to --testPathPatterns.
• Jest now properly handles promises that are first rejected and then later caught to avoid false positive test failures.
• We made various improvements to Jest’s printing of snapshots which might require you to update snapshots. Google deprecated goo.gl links which we were using in snapshots. We don’t like it either, but you’ll have to update all your snapshots.
• Jest itself is now bundled into a single file per package. This improves performance, but might break if you built tools that reach into Jest's internals.

These are just some of the highlights. The full list of breaking changes can be found in the CHANGELOG and the Jest 30 migration guide.

Performance & Memory Improvements​

Jest 30 delivers real-world performance gains thanks to many optimizations, especially related to module resolution, memory usage, and test isolation. By relying on the new unrs-resolver, module resolution in Jest became more feature-rich, standards-compliant, and faster. Thanks to @JounQin for the migration. Depending on your project, you may see significantly faster test runs and reduced memory consumption. For example, one large TypeScript app with a client and server observed 37% faster test runs and 77% lower memory usage in one part of their codebase:

Jest is fast, but due to Jest's test isolation, slow user code often exacerbates performance issues and leads to slow test runs. When tests leave behind open handles like unclosed timers or connections to other services, it can cause Jest to hang or slow down. Jest 30 has gotten better at detecting and reporting these issues, which helps you identify and fix slow or problematic tests more easily. For example, tests at Happo were sped up by 50% from 14 minutes down to 9 minutes by cleaning up open handles and upgrading to Jest 30.

If you are using files that consolidate the exports of multiple modules into a single file (i.e. "barrel files"), we recommend using tools such as babel-jest-boost, babel-plugin-transform-barrels or no-barrel-file to avoid loading large swaths of application code for each test file. This can lead to performance improvements of up to 100x.

Globals cleanup between test files​

Jest achieves test isolation between files by running each test in a separate VM context, giving each file a fresh global environment. However, if your code does not clean up globals after each test file, it can lead to memory leaks across Jest and slow down your test runs. Jest 30 introduces a new feature that notifies you about globals that are not correctly cleaned up after a test run.

In the future, Jest will automatically clean up globals after each test run. If you don't get any warnings about uncleaned globals with Jest 30, you can already set the globals cleanup mode to "on" now to enable this feature fully, and benefit from major memory savings and performance improvements:

export default {
  testEnvironmentOptions: {
    globalsCleanup: 'on',
  },
};

The default in Jest is globalsCleanup: 'soft'. To disable this feature you can set it to off. If you need to protect specific global objects from being cleaned up -- for example, shared utilities or caches -- you can mark them as protected using jest-util:

import {protectProperties} from 'jest-util';

protectProperties(globalThis['my-property']);

Thanks to @eyalroth for implementing this feature!

New Features​

Improved ECMAScript Module & TypeScript Support​

Support for import.meta.* and file:// was added when using native ESM with Jest. In addition, you can now write your Jest config files in TypeScript, and .mts and .cts files are natively supported without requiring extra configuration. If you are using Node’s native TypeScript type stripping feature, we no longer load the TypeScript transformer to strip types, leading to faster test runs.

Spies and the using keyword​

You can now use JavaScript’s new explicit resource management syntax (using) with Jest spies. If your environment supports it, writing using jest.spyOn(obj, 'method') will automatically restore the spy when the block ends, so you don’t have to manually clean up.

test('logs a warning', () => {
  using spy = jest.spyOn(console, 'warn');
  doSomeThingWarnWorthy();
  expect(spy).toHaveBeenCalled();
});

Documentation

expect.arrayOf​

Jest 30 introduces a new asymmetric matcher, expect.arrayOf, which lets you validate every element of an array against a condition or type. For instance, you can expect an array of numbers ensuring all items are numbers:

expect(someArray).toEqual(expect.arrayOf(expect.any(Number)));

Documentation

New test.each placeholder: %$​

If you use data-driven tests with test.each, you can now include a special placeholder %$ in your test titles to inject the number of the test case. Наприклад:

test.each(cases)('Case %$ works as expected', () => {});

will replace %$ with the test’s sequence number.

Documentation

jest.advanceTimersToNextFrame()​

@sinonjs/fake-timers was upgraded to v13, adding jest.advanceTimersToNextFrame(). This new function allows you to advance all pending requestAnimationFrame callbacks to the next frame boundary, making it easier to test animations or code that relies on requestAnimationFrame without having to guess millisecond durations.

Documentation

Configurable test retries​

Jest 30 enhances jest.retryTimes() with new options that give you control over how retries are handled. You can specify a delay or immediately retry a failed test instead of waiting until the entire test suite finishes:

// Retry failed tests up to 3 times, waiting 1 second between attempts:
jest.retryTimes(3, {waitBeforeRetry: 1000});

// Immediately retry without waiting for other tests to finish:
jest.retryTimes(3, {retryImmediately: true});

Documentation

jest.unstable_unmockModule()​

Jest 30 adds new experimental jest.unstable_unmockModule() API for finer control when unmocking modules (especially when using native ESM).

Documentation

jest.onGenerateMock(callback)​

A new onGenerateMock method was added. It registers a callback function that is invoked whenever Jest generates a mock for a module. This callback allows you to modify a mock before it is returned to your test environment:

jest.onGenerateMock((modulePath, moduleMock) => {
  if (modulePath.includes('Database')) {
    moduleMock.connect = jest.fn().mockImplementation(() => {
      console.log('Connected to mock DB');
    });
  }
  return moduleMock;
});

Documentation

Інші покращення​

Custom object serialization​

Jest’s matcher utilities now support defining a static SERIALIZABLE_PROPERTIES on custom objects. This allows you to control which properties of a custom object are included in snapshots and error messages, making the output more focused and relevant.

Documentation

Asynchronous setup support​

Test files listed in setupFilesAfterEnv can now export an async function or use top-level await similar to setupFiles.

And so much more…​

Check out the full CHANGELOG for all changes, improvements and new features.

Known Issues​

jsdom has made changes to become more spec compliant. This might break some use cases, most notably mocking window.location in tests. Jest now ships with @jest/environment-jsdom-abstract to make it easier for you to compose your own custom test environment based on jsdom. If you are just looking to patch jsdom, you can apply this jsdom patch to your project. In the future, we may look into providing an alternative to jsdom that is better suited for testing.

What's Next​

Jest has been the most popular JavaScript testing framework for a decade. It is used by millions of developers, supporting a wide range of projects from small libraries to the largest codebases in the world. Jest has constantly been improved over time, and as with all long-lasting software projects used in the real world, we accumulated technical debt. We support some features that only few people or companies use, and we have kept breaking changes to a minimum to avoid disrupting users. Some features should be made possible by Jest, but not as part of the core framework. Other features promote testing the wrong things, and should maybe not be part of Jest at all. In terms of Jest's team, a few of us moved on over time which led to slower progress and fewer releases. Here is how we are going to address these issues going forward:

• Performance / Technical Debt: Slim Jest down into a leaner, more performant core. Remove features that are not used by the majority of users, and focus on what makes Jest great.
• Consistent Release Cycles: We will aim to be more consistent with our release cycles and deprecation policies.
• Be Open: Build everything in the open, and be transparent about our plans. Provide more opportunities to get involved and increase the number of contributors.
• Be Bold: As the Jest team, we should be more bold. There are a bunch of things that holds Jest back from what it could be. It's time to make moves.

The great news is that Jest has always been well set up to deliver on these principles, ever since we built the framework as a modular system with clear separation of concerns. Now it's time to execute. More on all that soon!

Подяка​

This release wouldn’t have been possible without the hard work of our community. Дякуємо.

@SimenB, @mrazauskas, @Connormiha, @liuxingbaoyu, @k-rajat19, @G-Rath, @charpeni, @dubzzz, @stekycz, @yinm, @lencioni, @phawxby, @lukeapage, @robhogan, @fisker, @k-rajat19, @connectdotz, @alesmenzel, @rickhanlonii, @mbelsky, @brunocabral88, @brandon-leapyear, @nicolo-ribaudo, @dj-stormtrooper, @eryue0220

A special thanks to everyone who made their first contribution to Jest in this release. Thank you for making Jest better for everyone!

@eyalroth, @KhaledElmorsy, @mohammednumaan, @bensternthal, @BondarenkoAlex, @phryneas, @jayvdb, @brandonchinn178, @latin-1, @rmartine-ias, @fa93hws, @Dunqing, @gustav0d, @noritaka1166, @andreibereczki, @Dreamsorcerer, @satanTime, @icholy, @ecraig12345, @cgm-16, @sebastiancarlos, @dancer1325, @loganrosen, @zakingslayerv22, @dev-intj, @tez3998, @anbnyc, @pengqiseven, @thypon, @co63oc, @danielrentz, @jonasongg, @andrew-the-drawer, @phryneas, @hyperupcall, @tonyd33, @madcapnmckay, @dongwa, @gagan-bhullar-tech, @ikonst, @ZuBB, @jzaefferer, @brandonnorsworthy, @henny1105, @DmitryMakhnev, @askoufis, @RahulARanger, @Jon-Biz, @fynsta, @KonnorRogers, @BondarenkoAlex, @mouadhbb, @kemuridama, @Avi-E-Koenig, @davidroeca, @akwodkiewicz, @mukul-turing, @dnicolson, @colinacassidy, @ofekm97, @haze, @Vadimchesh, @peterdenham, @ShuZhong, @manoraj, @nicolo-ribaudo, @georgekaran, @MathieuFedrigo, @hkdobrev, @Germandrummer92, @CheadleCheadle, @notaphplover, @danbeam, @arescrimson, @yepitschunked, @JimminiKin, @DerTimonius, @vkml, @ginabethrussell, @jeremiah-snee-openx, @WillianAgostini, @casey-lentz, @faizanu94, @someone635, @rafaelrabelos, @RayBrokeSomething, @DaniAcu, @mattkubej, @tr1ckydev, @shresthasurav, @the-ress, @Mutesa-Cedric, @nolddor, @alexreardon, @Peeja, @verycosy, @mknight-atl, @maro1993, @Eric-Tyrrell22

The only breaking changes that should be noticeable are:

• Node versions 12 and 17 are dropped, both of which are EOL

• The snapshotFormat property is changed to:

  + snapshotFormat: {
  +   escapeString: false,
  +   printBasicPrototype: false
  + }
  

• jest-environment-jsdom has upgraded jsdom from v19 to v20

There are certain changes to the types exposed by Jest, but probably (hopefully!) nothing that should impede the upgrade. Please see the upgrade guide for more details.

That's it for breaking changes! Hopefully this means the upgrade path from Jest 28 is smooth. Please see the changelog for other changes.

Thanks for reading, and happy Jesting! 🃏

Today we're excited to announce that Jest is joining the OpenJS Foundation!

This change transfers ownership of the project from Meta to the Jest Core team via the OpenJS Foundation as an Impact Project. We’re grateful to Meta for creating Jest and all of their support over the years, and we look forward to the future of Jest as a project owned by the Jest community!

Check out the Meta Engineering blog and OpenJS Foundation blog announcements for more info.

Additionally, as announced in the Jest 27 blog post last year, we have removed some packages that no longer are used by default from the default installation. As a result the installation size has dropped by about 1/3.

Breaking changes​

The list of breaking changes is long (and can be seen fully in the changelog), but for migration purposes, we've also written a guide you can follow. Hopefully this makes the upgrade experience as frictionless as possible!

Main breaking changes likely to impact your migration are dropped support for Node 10 and 15 (but not Node 12, which will be EOL in a few days) and some renamed configuration options.

Please note that both of the removed modules (jest-environment-jsdom and jest-jasmine2) are still actively maintained and tested in the same way, so the only breaking change here is that you'll need to explicitly install them.

The guide should hopefully make migration trivial, but note that if you use any of the packages Jest consists of directly (such as jest-worker or pretty-format), instead of just running jest, then you need to go through the changelog to view any breaking changes.

Features​

Now let's talk about the new features in Jest 28, which is way more exciting! And there's quite a few of them, so buckle up.

Sharding of test run​

Jest now includes a new --shard CLI option, contributed by Mario Nebl. It allows you to run parts of your test across different machine, and has been one of Jest's oldest feature requests.

Jest's own test suite on CI went from about 10 minutes to 3 on Ubuntu, and on Windows from 20 minutes to 7.

package.json exports​

Jest shipped minimal support of exports in 27.3. However, it only supported the "main" entry point (.), and only if no main field was present in package.json. With Jest 28 we're excited to finally be shipping full support!

Related, in Jest 27, we provided either require or import condition. In Jest 28, jest-environment-node will now automatically provide node and node-addons conditions, while jest-environment-jsdom will provide the browser condition.

This has been one of the biggest compatibility issues of Jest, and hopefully this is now resolved once and for all.

Fake timers​

Jest 26 introduced the concept of "modern" fake timers, which uses @sinonjs/fake-timers under the hood, and Jest 27 made it the default. In Jest 28, we are now exposing more of the underlying implementation through both configuration and runtime APIs. Huge thanks to Tom Mrazauskas who contributed this feature!

This allows you to not mock out process.nextTick which improves compatibility with fake Promises, or to enable advanceTimers which automatically advance timers.

Please see the fakeTimers configuration for details.

GitHub Actions Reporter​

Jest now ships with a reporter to be used on GitHub Actions, which will use annotations to print test errors inline.

You can activate this reporter by passing github-actions in the reporters configuration option.

Huge thanks to Bernie Reiter and other contributors for sticking by us and finally landing this feature.

Inline testEnvironmentOptions​

You can now pass testEnvironmentOptions inline in a file, similar to how you can set test environment. This is useful if you want to e.g. change the URL in a single file.

/**
 * @jest-environment jsdom
 * @jest-environment-options {"url": "https://jestjs.io/"}
 */

test('use jsdom and set the URL in this test file', () => {
  expect(window.location.href).toBe('https://jestjs.io/');
});

All Node.js globals​

If you are using the new fetch implementation in Node v18, you might have noticed that this function is not available in Jest. It has been a long-standing issue that we have to manually copy over any globals into the test globals. With Jest 28, this is no longer an issue as we now inspect the global environment Jest itself is running in, and copy over any globals that are missing in the test environment.

Модулі ECMAScript​

Not much has changed in Jest's support for native ESM since Jest 27 came out. We continue to be blocked by stabilization in Node, and are hopeful this situation will improve sooner rather than later!

However, we have been able to add a couple of new features in Jest 28.

data: URLs​

Tommaso Bossi has contributed support for data URLs, meaning you can now inline define some JavaScript to run without using eval.

import.meta.jest​

While you have been able to access jest via import {jest} from '@jest/globals' in Jest, we've received feedback that this is less ergonomical than the (seemingly, but not really) global jest variable available in CJS. So Jest 28 ships with import.meta.jest to allow easier access.

Miscellaneous​

That's quite a lot of features, and are my personal highlights. However, we still have many more which I'll quickly go through:

Asynchronous resolvers​

Ian VanSchooten has contributed support for asynchronous resolvers, which enables tools like Vite to have better integrations with Jest.

Asynchronous setup files​

If you have some async work you want to do when using setupFiles, you can now export an async function, which Jest will call and await before loading any tests.

Note that this feature is only available for CJS. For ESM, we recommend using top-level await instead.

Using globalThis​

Internally, Jest has been using global to refer to the global environment. However, since this only exists in Node, and not browsers (window), this led to incompatibility when attempting to use Jest's modules in another environment.

Jest 28 uses globalThis instead, which works in all environments.

JSDOM 19​

While, as mentioned, Jest no longer ships jest-environment-jsdom in the default installation, it is still actively maintained. As part of that, Jest 28 has upgraded from jsdom@16 to jsdom@19.

TypeScript​

If you use Jest with TypeScript, either in your tests or when writing plugins such as custom runners, Jest 28 comes with extensive improvements to our types. Here's a non-exhaustive list of the changes in Jest 28.

expect​

When using expect's own types (either directly, or via import {expect} from '@jest/globals'), it's now finally possible to add custom matchers. See our example for how to do this.

Custom plugins​

If you write a custom runner, test reporter, resolver or something else, we now export more types that should help you type these more correctly. This is a moving target, so if you are the author of something pluggable in Jest and the types aren't as useful as they could be, please file an issue!

jest-runner-tsd​

jest-runner-tsd is a custom runner for running type tests. This is what Jest uses itself to test our types, and we hope it can also be used by others! As its name implies, it is based on tsd, although it under the hood uses the fork tsd-lite.

All of these improvements and fixes has been contributed by Tom Mrazauskas. Thank you so much, Tom! 👏

Lastly, the minimum support version of TypeScript is now 4.3.

jest-light-runner​

The last thing we want to highlight in this blog post, is a very cool new Jest runner, created by Nicolò Ribaudo, called jest-light-runner. This takes almost all of the DX Jest is known for, and speeds it way up by being a smaller abstraction on top of Node. Babel's tests became almost twice as fast after migrating. While there are caveats, the existence of this runner should make it even easier for people who have smaller Node modules to test to choose Jest. Thanks, Nicolò!

Future​

While Jest 28 came almost a year after Jest 27, Jest 29 will be coming sooner, probably in just a few months. The current plan then is to just have one breaking change (except dropping Node versions), and that is to default snapshotFormat to {escapeString: false, printBasicPrototype: false}. This makes snapshots both more readable and more copy-pasteable.

This will of course be possible to override if you don't want to change, but you can also use those options today if you don't want to wait!

Acknowledgements​

Jest 28 contains contributions from more than 60 people, of which more than two thirds are first time contributors. Thank you so much to all contributors, old and new. Without you the project wouldn't be nearly as good as it is! I'd particularly like to thank Tom Mrazauskas and Feng Yu for all their contributions, from code, to issue triaging to debugging, that made Jest 28 what it is. Thank you! 🙏

Thanks for reading, and happy Jesting! 🃏

With the first major change of defaults since the New Defaults for Jest that came with the seminal version 15, Jest 27 is now here, to keep Jest fast, lean, and relevant in the future. We will explain those changes of defaults and other notable breaking changes in this post, but first, let's get into some exciting new features!

Feature updates​

Firstly, the interactive mode you may know from reviewing and updating failed snapshots can now also be used to step through failed tests one at a time. Credit goes to first-time contributor @NullDivision for implementing this feature!

Speaking of snapshots, one of the more exciting features we've shipped in recent years are Inline Snapshots, which landed in a minor release of Jest 23 almost three years ago. However, they came with the restriction that projects wanting to utilize them must be using Prettier to format their code, because that's what Jest would use to make sure the file it writes the snapshots into remains properly formatted.
And so for most of these years, we've had a pull request in the pipeline to eliminate this restriction and allow using Inline Snapshots without Prettier. It has amassed well above a hundred comments, not even taking into account PRs split out from it and landed first, and even changed owner once after the initial submission by another first-time contributor, @mmkal under the hilarious working title 'Uglier Inline Snapshots'. With the stellar rise of Prettier in recent times, this improvement is now maybe less needed than back in 2018, but still, we know that feeling of getting into a project that does not use Prettier, and suddenly not being able to use inline snapshots anymore. Nevermore!

The main reason why it took us so long to land this was, somewhat surprisingly, an out of memory error on our build pipeline. It turns out that the dependencies we load for each test file to perform the parsing, snapshot insertion, and printing do incur a significant time and memory overhead.
So with some tricks, we've speed up the initialization per test file by roughly 70% compared to Jest 26. Note that you will almost certainly not see this big of a performance improvement on your project—you would need a lot of test files that each run very quickly to best notice this, and the overhead when using a JSDOM environment dwarfs any such improvement.

In other news, the native ESM support is progressing, but some major complexities, for instance around mocking, are still ahead of us, and we continue to observe the migration to ESM as a huge ecosystem effort, where Node and a lot of crucial tools and packages all have to rely on each other to deliver an overall compelling experience.
ESM support for plugging modules into Jest is more advanced—custom runners, reporters, watch plugins, and many other modules can already be loaded as ES modules.

We've also merged a PR to be able to deal with test files symlinked into the test directory, a feature much wanted by users of Bazel.

Another PR enabled transforms to be asynchronous, a requirement to support transpilation through tools such as esbuild, Snowpack, and Vite effectively.

Flipping defaults​

Up until now, if you were using Jest in its default configuration, you were—perhaps unknowingly—running some code forked many years ago from the test runner Jasmine 2.0 that provides test framework functions such as describe, it, and beforeEach. In 2017, Aaron Abramov initially wrote a replacement for the Jasmine code called jest-circus, meant to improve error messages, maintainability, and extensibility.
After years of large-scale use at Facebook and of course in Jest itself, as well as recent adoption in create-react-app, we are now confident that jest-circus is highly compatible with jest-jasmine2 and should work in most environments with little to no migration work. There may be minor differences in execution order and strictness, but we expect no major upgrade difficulties other than for code relying on Jasmine-specific APIs such as jasmine.getEnv(). If you rely extensively on such APIs, you can opt back in to the Jasmine-based test runner by configuring "testRunner": "jest-jasmine2".

Running tests in a JSDOM environment incurs a significant performance overhead. Because this was the default behavior of Jest unless otherwise configured up until now, users who are writing Node apps, for example, may not even know they are given an expensive DOM environment that they do not even need.
For this reason, we are changing the default test environment from "jsdom" to "node". If you are affected by this change because you use DOM APIs and do not have the test environment explicitly configured, you should be receiving an error when e.g. document is accessed, and you can configure "testEnvironment": "jsdom" or use per-file environment configuration to resolve this.
For mixed projects where some tests require a DOM environment but others don't, we recommend using the fast "node" environment by default and declaring exactly those tests that need the DOM using docblocks.
In the next major, we plan to also eliminate jest-jasmine2 and jest-environment-jsdom from the Jest dependency tree and require them to be installed explicitly, so that many users can profit from a smaller install size with less clutter that they don't need.

Another default that we are changing affects Fake Timers aka Timer Mocks. We introduced an opt-in "modern" implementation of Fake Timers in Jest 26 accessed transparently through the same API, but with much more comprehensive mocking, such as for Date and queueMicrotask.
This modern fake timers implementation will now be the default. If you are among the unlucky few who are affected by the subtle implementation differences too heavily to migrate, you can get back the old implementation using jest.useFakeTimers("legacy") or, if you are enabling fake timers globally via configuration, "timers": "legacy".

Features coming with breaking changes​

We introduced a few more small breaking changes to help you avoid mistakes by disallowing some things that can easily happen unintentionally:

• The same done test callback may not be called more than once,
• calling done and returning a Promise may not be combined,
• a describe block must not return anything,

and we made some TypeScript types stricter.

Modules used in the following configuration options are now transformed like the rest of your code, which may be breaking if you relied on them being loaded as-is:

• testEnvironment
• runner
• testRunner
• snapshotResolver

Miscellaneous breaking changes​

We removed some long-deprecated functions:

• jest.addMatchers (use expect.extend instead)
• jest.resetModuleRegistry (use jest.resetModules instead)
• jest.runTimersToTime (use jest.advanceTimersByTime instead)

A lot of Jest's packages have been migrated to use ESM-style exports (although they are still shipped as CommonJS), so if you consume e.g. pretty-format directly, you may need to adjust your import to a default import.

We dropped support for Node 13—but Jest always supports the Current and all LTS Node versions, and Jest 27 continues to support Node 10, which only recently became unmaintained.

As always, the full changelog and list of breaking changes can be viewed here.

Finally, we'd like to thank the community for once again awarding Jest a sky-high satisfaction rating of 96% in the State of JS 2020 survey! Stay safe everyone, and we hope you continue to enjoy using Jest in the years and versions to come! 🃏

The Jest site was upgraded from Docusaurus 1 to Docusaurus 2, and is an early adopter of the newly released Docusaurus 2 i18n support.

So, what's new exactly?

Що нового?​

Here's a good overview of the most visible improvements:

• Dark Mode: change the color scheme through the navbar switch.

• Modern navigation: we improved the navigation experience with client-side routing and prefetching.

• Versions dropdown: it is now simpler to switch from one Jest version to another.

• Progressive-Web-App: you can install the Jest website and browse it offline.

• Search: try the new Algolia DocSearch v3 user-experience. It is now possible to search in blog posts.

• I18n: Jest is the first website using the new i18n feature of Docusaurus 2. It is now possible to translate blog posts.

• MDX: embedding React components in Markdown will allow maintainers to make the documentation more interactive.

For site translators​

If you want to help to translate the new Jest website, please use the new Crowdin project jest-v2 instead of the previous one.

Подяка​

Thanks to all the contributors that supported or reviewed this migration: Simen, Orta, Joel, Kristoffer...

Please report any problem on the migration issue.

We are now beginning to address this shortcoming and are working on reducing Jest’s install size while keeping it approachable and extensible. We have made the following breaking changes in Jest 26:

• [expect, jest-mock, pretty-format] Remove ES5 build files with a new minimum of support of ES2015 (Node 8) which were only used for browser builds (#9945)

  Migration: With this change, we are pushing the responsibility to bundle the affected packages to the users, rather than Jest providing them out of the box, since they know their target environments best. If you want it back, we're open to shipping these as separate packages. PRs welcome!

• [jest-config, jest-resolve] Remove support for browser field (#9943)

  Migration: Install browser-resolve module and use the following configuration:

  {
    "jest": {
      "resolver": "<rootDir>/resolver.js"
    }
  }
  

  // resolver.js
  const browserResolve = require('browser-resolve');
  
  module.exports = browserResolve.sync;
  

• TypeScript definitions requires a minimum of TypeScript v3.8 (#9823)

With the above changes Jest 26 is now 4 MiB smaller than Jest 25.5.4 (53 → 49 MiB). Please keep in mind that many dependencies like Babel are likely already part of your project. Jest's own size was reduced by 1.2 MiB (4.3 -> 3.1 MiB).

While this is a good start, it isn’t enough to make Jest meaningfully leaner. We are planning on gradually reducing Jest's and its dependency tree size by up to 70%. Most of the changes to reduce Jest’s default setup will be small breaking changes and we want to bring the community with us as much as possible. Therefore we will make the following changes in Jest 27 and Jest 28 using a “Tick-Tock" release process:

• Jest 27 will ship with a new test runner "jest-circus" and the Node.js environment by default. jest-jasmine2 and jest-environment-jsdom will still be bundled so users can keep using them by changing one-line each in the configuration.
• Jest 28 will remove jest-jasmine2 and jest-environment-jsdom from the default distribution of Jest. The packages will still be actively maintained as part of the Jest project and be published separately. Users will need to install these packages to use them.

Upon upgrading to these major releases, Jest will guide you through the necessary changes. Якщо ви зараз захочете перейти до нових значень за замовчуванням і ваш проект не потребує DOM середовища. ви можете покращити до Jest 26 і додати наступні параметри конфігурації:

{
  "jest": {
    "testEnvironment": "node",
    "testRunner": "jest-circus/runner"
  }
}

Jest will continue to ship with babel-jest enabled by default. It currently powers a few Jest features beyond compiling modern JavaScript syntax to something understood by current versions of Node.js and browsers: It also powers Jest's code coverage and mocking of ES modules. Jest currently ships with experimental support for V8 coverage and native support for ES Modules (more on that below!). It is not possible to mock static ES Modules per the specification without transforming the code first, so we will be encouraging patterns that work without the transformation we use Babel for today. Once V8 coverage and native ESM support stabilizes in Jest, we will also be able remove babel-jest as a default but we will keep maintaining it.

New fake timers​

With Jest 26 we are shipping a new implementation of fake timers based on @sinonjs/fake-timers. We've wanted to do this for years and are happy this has finally progressed far enough to support all of Jest's existing fake timer use cases.

The new implementation comes with extra features such as mocking Date, queueMicrotask and more, see this README. It works transparently using the existing timer APIs like jest.runAllTimers() – check out the documentation on our website.

We are confident this implementation is ready for prime time, however we don't want to force people to rewrite their tests if they depend on subtle differences between the old and new implementation. In Jest 26, this new implementation will remain opt-in and can be activated by calling jest.useFakeTimers('modern') or by passing modern to the timers option in your config if you opted all tests into fake timers previously.

In Jest 27 we will swap the default to the new "modern" implementation but we will keep supporting and maintaining the legacy implementation which can be used by calling jest.useFakeTimers('legacy'). If you are unsure whether you'll be able to upgrade all your tests by the time Jest 27 rolls out, you can add this to your tests now to keep the old behavior.

We'd like to thank Carl-Erik Kopseng, Benjamin Gruenbaum and other maintainers of @sinonjs/fake-timers for their help and patience when working with us to make this happen! Exciting.

A new way to consume Jest - @jest/globals​

Jest has relied on globals popularized by the Jasmine testing framework and others such as describe, it, test and expect. While this is a widely used pattern, many people have expressed their preference for importing testing related functions instead. To support this use case, we added a new package @jest/globals that can be used to import testing functions: import {expect, jest, test} from '@jest/globals';.

Caveats:

• Currently the globals still exist in the environment but we will introduce a mode to disable globals in the future. Similarly, you cannot use const jest = require('@jest/globals') as you'll get declaration errors because the jest variable is still a global for now.
• There is currently no way to add custom matchers to the TypeScript definitions when using globals like this.
• While this allows running tests without globals, it does not allow running tests without Jest's test runner at this time.

Native ESM support​

As mentioned in the Jest 25 blog post we have been working on native support for ECMAScript Modules. It is not stable yet but it is ready to be tested. We'd love to hear your feedback and bug reports! For an overview of the current state you can check out this issue, or browse all issues with that label ES Modules.

Other Breaking Changes in Jest 26​

• Dropped support for Node 8 (#9423)
• [jest-environment-jsdom] Upgrade jsdom to v16 (#9606)
• [jest-runtime] Remove long-deprecated require.requireActual and require.requireMock methods (#9854)
• [jest-haste-map] Removed providesModuleNodeModules (#8535)
• [jest-circus] Fail tests if a test takes a done callback and have return values (#9129)
• [jest-circus] Throw a proper error if a test / hooks is defined asynchronously (#8096)

Stay Safe​

We are all currently experiencing an unprecedented time of uncertainty. If you are struggling financially, we would like to use Jest’s Open Collective fund to help new and existing contributors. We place bounties on some issues and are open to offering a bounty on any of our current open issues - you can mention that an issue should have a bounty in the issue or contact @cpojer via private message on Twitter.

Please stay safe.

There has been more than 200 commits since Jest 24.9 by more than 80 different contributors, so as always, take a look at the changelog for a full list of changes.

Бувай, Node 6​

Node 6 завершив існування 30 квітня 2019, тож Jest 25 залишає його позаду. Видалення Node 6 означає, що ми можемо оновити залежності, найголовніше - JSDOM, що було оновлено до версії 15. Upgrading also means we no longer have to transpile async-await syntax, which results in both faster code execution and less memory consumption. Додатково, перекладений код Jest повинен бути простішим в налагоджені, якщо комусь доведеться в тому розбиратись.

Навіть якщо Node 8 також став EOL, Jest 25 підтримуватиме його, щоб зробити оновлення якомога простішим для тих з нас, хто досі підтримує Node 8. It does come with some tradeoffs though, such as JSDOM v16 having been released without Node 8 support, so you'll need to use jest-environment-jsdom-sixteen if you want to use the latest version.

Покращення продуктивності​

За останні декілька релізів, ми отримали повідомлення про вповільнення Jest. Jest 25 містить оновлений Micromatch, яке дає величезну перевагу під час запуску, та деякі виправлення помилок і налаштування продуктивності, які повертають Jest швидкість версії 23. Як було зазначено на початку цього допису, для Jest це означає 10-15% зменшення часу виконання тестів. Ми завжди прагнемо вдосконалити цей момент, тож, будь ласка, перевірте, як він порівнюється з більш ранніми версіями та створіть проблеми, якщо ми маємо щось покращити!

Покриття коду V8​

Jest’s current code coverage instrumentation is powered by babel-plugin-istanbul inserting code coverage collection code before creating reports. Однак це доволі повільний процес, що використовує багато пам'яті, особливо для великих файлів та баз коду. Luckily, V8 has built-in code coverage, which is becoming more and more usable in Node thanks to the hard work of Benjamin Coe and others on the V8 and Node.js teams. Jest 25 comes with experimental support for this via a new --coverage-provider flag. Please see its documentation for caveats and how to use it.

Думаємо швидко та повільно щодо провальних тестів​

Зайві зусилля для розуміння звітів провальних тестів заважають:

• “думати швидко”, розпізнаючи шаблони вашого минулого досвіду
• “думати повільно”, аналізуючи зміни та вирішуючи, чи є вони очікуваним прогресом або несподіваним регресом

Jest 25 завершує другу половину процесу, розпочатого в Jest 24, щодо покращення усіх матчерів:

• correct description line, including .rejects, .resolves, and .not modifiers
• лаконічні мітки та послідовність щодо очікуваних та отриманих значень
• інвертоване підсвічування підрядків розбіжностей, коли очікуються та отримуються рядки
• кількість рядків змін, для розуміння типу зміни (лише видалення/додавання)

Special thanks to Jest maintainer Mark Pedrotti for driving this effort and his continued work towards making expectation errors as good as they can be.

Кольори відмінностей при провалі тестування знімками​

Найбільш очевидною зміною для боротьби з плутаниною стали кольори рядків відмінностей у випадках, коли тести знімків провалюються:

• - Snapshot changes from green to magenta
• + Received changes from red to teal foreground on cyan/aqua background

Приклади звітів тестів знімками (до ліворуч, після праворуч)

1. Кількість змінених ліній підтверджує ваше перше враження щодо зміни знімків (тобто видалених або вставлених рядків)

2. Колір фону спрощує візуальне порівняння змінених рядків

3. Background colors also help you see which toThrow tests require a decision whether or not to update the snapshot

Наведемо кілька причин, чому ми обрали унікальні кольори:

• 95% людей, які повноцінно бачать кольори, можуть швидко визначити, які звіти стосуються тестів зі знімками, а не інших матчерів.
• Це вирішує прямий конфлікт між значенням зеленого/червоного кольорів у тестах Jest, порівнюючи з перевіркою коду.
• На відміну від червоного/зеленого кольорів, через які можна припустити, що оновлення є рішенням за замовчуванням, нинішня візуалізація показує, що відмінності вимагають більш ретельного розгляду на предмет можливої регресії в локальних помилках тестування знімками, а не перевірці коду (коли проблеми вже виправлені).

Різниця у тональності від пурпуру 300° до відтінків блакитного 180° дає кращу видимість кольорів, а світлий відтінок фону для змінених ліній забезпечує постійний контраст у світлих і темних темах.

If you maintain a command line tool, you might find inspiration to improve its accessibility in #9132.

Підтримка модулів ECMAScript​

Node 13 прибрав позначку підтримки ESM, тож ми почали потроху працювати над вбудованою підтримкою в Jest. Jest 25 includes support for jest.config.cjs and jest.config.mjs configuration files, but tests themselves cannot yet be written using ESM without something like Babel or TypeScript transforming it into CJS.

API, які використовуватиме Jest, все ще позначені як експериментальні, тому наразі не очікуйте підтримки. These APIs are something the Node.js Modules team is actively working on, and we'll be keeping an eye on it moving forward and experiment with them so we can provide feedback. You can subscribe to this issue to get any updates about the implementation status in Jest.

Інші вдосконалення та оновлення​

• Jest has passed 1000 unique contributors. Це неймовірне досягнення! Дякуємо всім, хто допомагає нам робити тестування якомога приємнішим.
• Thanks to community member Josh Rosenstein, Jest now comes with support for BigInt in most matchers, such as toBeGreaterThan. Jest також приймає bigint літерали з коробки.
• Jest’s feature --detect-leaks has been broken for Node 12 and newer - this has been fixed in Jest 25.
• Як було оголошено в дописі блогу про Jest 24, базу коду Jest було переписано на TypeScript. Ця робота була завершена в Jest 24.3. Якщо ви використовуєте будь-яку з окремих частин Jest, ви маєте отримати відмінну інтеграцію IDE. Надалі ми дійсно хочемо покращити взаємодію Jest імітацій з системами типів; допомога спільноти в цьому не завадить. Please chime in here with ideas and send PRs! Також ми будемо досліджувати переміщення типів для використання виконавця тестів Jest з DefinitelyTyped в самий Jest.
• The jest-diff package now exports functions like diffLinesUnified and diffStringsUnified which have configuration options, so other applications can format differences in a custom way. For more information and code examples, see its new README.md file in the Jest repository or on package repositories.
• Thanks to community member Wei An Yen, Jest will no longer highlight passing asymmetric matchers in expectation errors. Це була давня проблема асиметричних матчерів і ми дуже раді, що вона нарешті вирішилась.
• For the second year running, Jest won the Highest Satisfaction award from State of JS. Ми неймовірно вдячні за підтримку спільноти та сподіваємося, що зможемо продовжити такий рівень активності та покращитись за 2020 рік!

Плани на майбутнє​

• Jest’s configuration is vast and somewhat clunky - there is often at least two ways of doing the same thing, oftentimes even more. В Jest 26 ми сподіваємось зменшити конфігурацію та зробити її більш передбачуваною. See this issue for details.
• We also hope to be able to provide a proper programmatic API for running Jest, to make integration into IDEs and other tooling easier. Please see this tracking issue.
• There’s been an open PR for adding Lolex as an implementation of Jest’s fake timers since December 2017. While we’re not adding it to any public APIs in Jest 25, support for it is technically included and you we're looking into how to expose this so people can test and experiment with it. Using it means you can mock out Date and other timer function Jest currently doesn’t touch. Зверніть увагу, що це слід вважати експериментальним, і відповідна підтримка API буде в більш пізньому релізі. Follow this PR for the latest updates on the status.

Happy Jesting! 🃏

For a full list of all changes see the changelog.

Новий вебсайт​

@orta has provided a beautiful redesign of Jest's website, which has been implemented by community members @montogeek and @brainkim.

Метою редизайну було виділити більше чудових моментів Jest та розвіяти міт, ніби Jest є насамперед інструментом для тестування додатків React - ви можете використовувати Jest на різних проєктах і ми хочемо, аби це було для всіх очевидним. You can read more about the ideas behind the redesign in this issue.

Підтримка TypeScript​

З Jest 24, ми внутрішньо оновилися до Babel 7, що надало підтримку проєктів TypeScript. That means Jest can support transpiling TypeScript out of the box, as long as you configure Babel to use it with @babel/preset-typescript. Єдина незручність підтримки TypeScript за замовчуванням, аналогічна Flow, це те, що Babel вилучить лише анотації типів, щоб зробити ваш код дійсним JavaScript. It will not typecheck your code.

У той час як Jest підтримував Babel 7 з версії 22, випущеної в грудні 2017, це вимагало використання перехідного модуля, щоб співпрацювати з Jest підтримкою Babel 6. In Jest 24 we have migrated entirely over to Babel 7, with great help from community member @milesj. This means that setup is now easier and we can take advantage of other Babel 7 features, such as config loading and automatic modules transpilation. Make sure to remove the babel-core@^7.0.0-bridge.0 as it's not needed now.

If you want to run typechecks while you test, you should use ts-jest. You will need to configure the transformer, as Jest by default applies Babel to .ts (and .tsx) files. Alternatively, you can run tsc or even use a Jest runner to simultaneously transpile your TypeScript whilst running your tests! See jest-runner-tsc for more information.

See the docs for more details.

test.todo​

В Jest 23 змінив пропуск тестів без реалізації на кидання throw. Ця зміна була зроблена через зворотний зв'язок; було зазначено, що випадково пропущені тести важко було знайти та відстежувати. Однак ця зміна зламала робочий процес для багатьох розробників, які використовували функцію для приблизної оцінки, які тести потрібно писати.

In Jest 24, we are addressing this issue by adding an explicit test.todo (inspired by the excellent AVA), which will be printed separately in the test summary. It allows you to quickly sketch out which tests you want to write and in the future, an ESLint rule might even be able to warn you that you have forgotten to write out some tests.

test.todo('invalid input should throw');

test.todo('missing options should be normalized');

Покращені повідомлення тверджень​

Коли тести провалюються, вам потрібно приймати впевнено та правильно вирішити, які зміни є очікуваним прогресом, а які несподіваним кроком назад. Особливо важливо не пропустити кілька проблем, захованих серед великого прогресу. Jest 24 робить звіти провальних тверджень яснішими та лаконічними для випадку декількох матчерів. Ініціатива буде продовжена у Jest 25, тож ви можете помітити деякі тимчасові невідповідності. Якщо ваші тести ніколи не провалюються, то ви не зможете їх побачити; для інших буде простіше знайти, чому щось не працює належним чином. Thanks for the hard work by @ittordepam and other contributors from the community.

You can see these changes across all these PRs: 7621, 7557, 7448, 7325, 7241, 7152, 7125, 7107, 6961.

Приклади:

Провальні твердження

Невідповідність типів

Функція-імітація не викликається

Чинимо давні проблеми​

В цьому релізі, ми виправили пару дійсно старих проблем.

The first one we'd like to highlight is console.log statements going missing. Jest перехоплює та збирає всі логи для того, щоб надати вам трасування стеку, а також віддати генераторам звітів, щоб ви змогли використовувати їх як заманеться. Однак, це призвело до проблеми їх відсутності в певних крайніх випадках. Luckily for Jest 24, @spion has stepped up and fixed this issue. Щиро дякуємо!

Друга - це проблема дефіциту пам'яті Jest, якщо різниця в серіалізації очікуваного та отриманого значень має величезну кількість внесених змін (неочікувано через помилку в тесті або дефекті серіалізатора, або ж очікувана через тимчасові провали під час розробки через тестування). @ittordepam has replaced the previous diffing algorithm with diff-sequences package, which should fix this issue because it uses the theoretical minimum amount of memory. It opens up possibility for word-diffs in the future, similar to what git provides. Please see this PR and don't hesitate to reach out if you want to help make that happen!

Інші зміни​

• We have some improvements for globalSetup and globalTeardown as well - code transformation will be applied to them similar to setupFiles and they are now supported as part of projects.
• You can configure Jest's snapshot location, this is mainly useful if you are building tools which use Jest in a larger build process.
• A quirk of Jest's CLI has been that while some flags and options have been camel cased (such as runInBand), others have not been (such as no-cache). У Jest 24, обидва розпізнаються, що означає, що ви можете писати аргументи командного рядка будь-яким чином.
• We've renamed setupTestFrameworkScriptFile to setupFilesAfterEnv, and made it into an array. Сподіваємося, стане більш зрозумілим, для чого необхідні опції. Ми маємо плани надалі знову переглянути конфігурацію, дивіться абзац у розділі нижче.
• To reduce the amount of magic Jest performs to “just work™”, in this release we decided to drop automatic injection of regenerator-runtime, which is sometimes used in compiled async code. Including regenerator-runtime is not always necessary and we believe it's the user's responsibility to include it if it's needed. If you use @babel/preset-env with targets set to a modern Node version (e.g. Node 6+) you will not need to include it. Please see our Using Babel docs for more information.
• Node.js 10 came with an experimental module called worker_threads, which is similar to Worker threads in the browser. jest-worker, part of the Jest platform, will be able to use worker_threads if available instead of child_process, which makes it even faster! Benchmarks show a 50% improvement. Через свою експериментальну природу, функцію вимкнено при використанні Jest як виконавця тестів, але ви вже можете використовувати її у своїх проєктах! Ми плануємо включити його за замовчуванням, коли його підвищать з експериментального статусу в Node.js.

Важливі Зміни​

While all breaking changes are listed in the changelog, there's a few of them that are worth highlighting:

• Ми оновились до Micromatch 3. Хоча це може не вплинути на кожного користувача, він більш жорсткий при парсингу пошуку по масці, ніж у версії 2, яка використовується в Jest 23. Please read through this and linked issues for examples of invalid globs in case you have problems.
• Ми видалили залишки коду, необхідні для Node 4. Раніше можна було запустити Jest 23 на Node 4, що стало неможливим без полінаповнювання та транспіляції.
• Деякі зміни для серіалізації функцій-імітацій в знімках - не забудьте перевірити знімки після оновлення. Related PR.
• Jest no longer automatically injects regenerator-runtime - if you get errors concerning it, make sure to configure Babel to properly transpile async functions, using e.g. @babel/preset-env. Related PR.

Майбутнє​

We are incredibly humbled by the results in State Of JS 2018, where Jest won the “Highest Satisfaction” award. Ще однією великою подією, що вперше відбулася у жовтні 2018 році, стало досягнення Jest 2 мільйонів завантажень за тиждень. Дякуємо.

Ми дуже вдячні за довіру спільноти та сподіваємося підтверджувати її в майбутньому. Ми продовжимо будувати Jest 24 та майбутні релізи на цій неймовірній основі, і надалі бути невіднятною частиною інструментів JavaScript розробників.

Це був перший реліз, в якому ми досліджували ідею використання нашого фонду Open Collective для створення винагороди за знайдені помилки. This worked well in getting non-core developers involved in the implementation of the new landing page, and we're optimistic for a long running bug where Jest globals are mismatched from Node globals. Ми хотіли б зробити більше, тож якщо у вас є невелика помилка, що в теорії є гарним кандидатом для нашої програми, повідомте нас про це. In the meantime, you can find all the tickets with a bounty via the issue label.

Ми вже почали розробляти плани для наступного релізу Jest 25; найбільшою запланованою функцією стала капітальна зміна нашої конфігурації, яку здійснити складно, в основному через перетин опцій, змішані пошуки та регулярні вирази. Feedback on how you want Jest's configuration to look is very much welcome, and can be submitted in this issue.

Ви також могли чути, що ми плануємо перенести кодову базу з Flow на TypeScript. Ми сподіваємось, що ця міграція дозволить ще більшій кількості учасників долучитись та допомогти зробити тестування JavaScript у 2019 році ще кращим. 🚀 План полягає в тому, щоб втілити це в мінорному релізі в найближчий час. Feedback on this choice can be added to the RFC.

Lastly, if you've ever wondered about how Jest is built, @cpojer has recorded a video with an architectural overview of how Jest is put together under the hood. Якщо у вас є будь-які інші запитання з цього приводу, сміливо задавайте їх нам. The video is available on our website.

Happy Jesting! 🃏

Наші дописувачі вихідного коду працюють над створенням нового функціоналу, виправленням помилок та підтримувати список завдань. Співробітники Facebook роблять те саме, зосереджуючись на специфічних проблемах масштабування, і запускають усі запропоновані релізи на величезному тестовому комплекті Facebook перед публікацією.

Усі ми робимо свою частину, щоб зробити тестування приємним.

На саміті Jest ми оголосили про Jest Open Collective. Це наш спосіб допомогти підтримати зусилля спільноти з відкритим вихідним кодом Jest. To be absolutely clear: Facebook employees cannot benefit from the Jest Open Collective. The collective's sole purpose is to support the open source side of the Jest community.

В цьому повідомленні ми опишемо те, що собою являє Jest Open Collective, структуру та наявні цілі.

Jest Open Collective​

Open Collective є платформою для видимого управління групами людей. Jest joins projects like webpack, Babel, Mocha, Preact, Vue, and many more in supporting the open source community through the Open Collective platform.

Що таке Jest Open Collective​

Jest Open Collective - це група розробників відкритого вихідного коду, які працюють над:

• Отримуванням коштів від меценатів та спонсорів
• Затвердженням витрат, запропонованих спільнотою
• Наданням публічно видимих бюджетних звітів

Яка структура ініціативи​

На цю мить Jest Open Collective керують три базові розробники з відкритим вихідним кодом(не з Facebook):

• Michal Pierzchala
• Simen Bekkhus
• Rick Hanlon

Facebook був активним дописувачем Jest з вересня 2016 року, Simen приєднався до основної команди в червні 2017 року, Rick приєднався в січні. Вони відповідальні за встановлення бюджету, схвалення витрат і управління адміністраторами ініціативи. We have elected to keep Christoph Nakazawa as an adviser.

Є два рівні підтримки цього проєкту: Меценат і Спонсор.

Меценати​

Backers of the collective are individuals contributing at least $2/month. Ми додали список меценатів на головну сторінку Jest, README на github/yarn/npm та на сторінку учасників.

Спонсори​

Спонсори ініціативи - це особи та організації, що вносять щонайменше 100$/місяць. Ми додали логотипи спонсорів з посиланнями на їх сайти на головну сторінку Jest, README на github/yarn/npm та на сторінку учасників.

Яка ціль ініціативи​

Мета колективної роботи - підтримати розробників відкритого вихідного коду Jest для того, щоб зробити тестування приємним.

Для досягнення цієї мети, ми використаємо кошти на:

• Покриття витрат на поїздки для представників
• Проведення зустрічей
• Друк та розповсюдження тематичних матеріалів
• Розробку та фінансування програми винагород (TBD)

Це тільки початок, але ми прагнемо зробити все правильно. If you have ideas on how else we can support the community, or feedback on the structure of the collective, please reach out to us on twitter!

Дякуємо​

Врешті-решт, дякуємо усім, хто долучається до справ спільноти Jest та відкритого вихідного коду загалом. Ми безмежно вдячні за можливість покращувати тестування JavaScript разом з вами.

Основна команда Jest також хотіла б окремо подякувати Facebook Open Source за сприяння цій ініціативі.

We would also like to welcome both Babel and webpack to the Jest community! Після переходу з Mocha на Jest 23 Beta, webpack отримав зменшення загального часу виконання тестових наборів в 6 разів, з 13 хвилин до 2 хв 20 секунд. #blazingmeansgood

Ось деякі з Jest 23 новинок і принципових змін.

For a full list see the changelog.

Інтерактивний режим знімка​

Ми додали нову опцію меню спостереження за замовчуванням під назвою Інтерактивний режим знімка. Цей новий режим дозволяє вам проходитись через кожен невдалий знімок в кожному провальному наборі, аби переглянути та обрати оновити або пропустити кожен окремо.

See the Interactive Snapshot Mode docs here.

Матчери властивостей знімків​

Часто об'єкти, які ви знімаєте, містять згенеровані значення, такі як дати та ID. Jest тепер дозволяє передавати властивості в матчери знімків, які визначають структуру даних замість конкретних значень. Ці матчери властивостей будуть перевірені перш ніж серіалізувати тип матчера (замість значення), надаючи вам послідовні результати знімків виконання тестів.

See the updated toMatchSnapshot docs or the Property Matcher guide for more information.

Користувальницькі асинхронні матчери​

We now support asynchronous matchers with expect.extends! Async matchers return a Promise so that you can await for the matcher to resolve. Для прикладу:

Docs available here.

Користувацькі асиметричні матчери​

Асиметричні матчери є відмінним інструментом, якщо ви дбаєте тільки про асиметричну рівність. Наприклад, коли ліва сторона повинна бути об'єктом з деяким підмножиною властивостей праворуч замість точного збігу. Jest надає ряд вбудованих асиметричних матчерів, і в цьому релізі ми додаємо користувацькі асиметричні матчери.

Jest Each​

@mattphillipsio has donated the jest-each package to Jest Core (thanks Matt!). jest-each is a library inspired by mocha-each and Spock Data Tables which allows you to define a table of test cases, and then run a test for each row with the specified column values. We support both array types and template literals for all flavors of describe and test. Docs are available here, and for those not on Jest 23 yet, we're still publishing jest-each separately!

Huge shout out to Prettier for fixing the table formatting so quickly (see Prettier 1.13)!

Нові матчери​

We only add matchers to core if we believe they will be useful to a large amount of people in the Jest community, and leave the majority of matchers to the community (see jest-extended). Деякі матчери потрапили в основний склад з Jest 23:

• nthCalledWith
• toReturn
• toReturnTimes
• toReturnWith
• lastReturnedWith
• nthReturnedWith
• toStrictEqual

See the updated expect docs here.

Налагодження зависання тестів​

Розповсюджена проблема, яку ми помітили, стосується моменту зависання Jest після виконання тестів. Зазвичай, це стається через програмний код, який залишає відкриті елементи керування, заважаючи завершенню роботи Jest. In the past, users have resorted to --forceExit to fix (not recommended).

Аби допомогти відстежувати подібні проблеми, відтепер ми знаходимо моменти, на яких Jest не завершує свою роботу:

And we offer a new flag --detectOpenHandles to help find the open handles:

See the updated CLI docs here.

Плагіни режиму спостереження​

Ми повністю переписали систему режиму спостереження, що дозволить додавати користувацькі плагіни в цей режим. Тепер плагіни режиму спостереження дозволяють підключатись в події Jest та надавати користувацькі опції в Меню режиму спостереження. All of the default Watch Mode prompts are implemented as plugins in this system, and the docs to create your own are available here.

With this change, we're also now able to bring back typeahead support as a Watch Mode Plugin via jest-watch-typeahead!

See jest-watch-typeahead for documentation and install instructions. Huge thank you to @rogeliog for the new watch mode plugin system and the jest-watch-typeahead plugin!

Важливі Зміни​

Як і в кожному великому релізі, ми здійснюємо кілька змін для внесення більших змін в майбутньому, а також для того, щоб вивести досвід тестування на новий рівень. Ось список найбільших змін:

• Require test descriptions and functions: We're now failing tests that do not include both a function and a description.
• Remove undefined props from React snapshots: Smaller snapshots and proper React behavior.
• Remove deprecations: We removed mapCoverage since it's no longer needed. Additionally, we removed jest.genMockFunction and jest.genMockFn since these are the same as jest.fn.
• Add snapshot names to failures: We added the snapshot name (if provided) to the snapshot failure message so it's easier to find the snapshot that's failing.
• Replace mock timestamps: We replaced mock timestamps with invocationCallOrder since two or mocks may often have the same timestamp, making it impossible to test the call order.
• Add results to mock snapshots: We added mock function call results to snapshots so that both the calls and the results of the invocation are tracked.

Інші покращення​

• Watch mode coverage: Coverage is now limited to only the files tested in watch mode or when using --onlyChanged and --findRelatedTests.
• Version documentation: We added docs for each minor release back to Jest 22, and have removed all of the “Requires Jest X.X+” from the docs.
• Better snapshot summaries: We overhauled the Snapshot Summary output to make obsolete snapshots more informative.
• Better stack traces: We added stack traces to asynchronous errors, timeout errors, expect.assertions, and thrown non-errors. Також ми вказуємо стовпець в коді фрейму!
• Better React 16 support: Adds snapshot support for React.Fragment, React.forwardRef, and React.createContext.
• Track mock return and throw values: Adds mock.results that contains the return value or thrown value for each mock call.
• Blazing 🔥: We've added a blazing badge to the README to indicate that Jest is blazing good.

Саміт Jest​

Минулого тижня команда Jest зустрілася на саміті Jest у Facebook, Лондон, де розробляли та випустили Jest 23, оголосивши про Jest Open Collective та виступивши з кількома промовами:

• Christoph Nakazawa – Intro
• Aaron Abramov – Writing Meaningful Tests
• Rick Hanlon II – Blazing Fast Snapshot Testing in Jest 23
• Simen Bekkhus – Jest's Delightful Error Messages
• Matt Phillips – Level up your Jest experience with community packages
• Michele Bertoli – Snapshot all the things
• Jordan Eldredge – Webamp: Learn by imitating

Full talk is available here.

Все пройшло чудово, ми змогли персонально зустрітись з лондонською частиною спільноти. Дякуємо усім, хто долучився, за вашу постійну підтримку! Очікуйте наш наступний допис щодо Jest Open Collective та планів на майбутнє.

As always, this release couldn't have been possible without you, the JavaScript community. Ми безмежно вдячні за можливість покращувати тестування JavaScript разом з вами. If you'd like to contribute to Jest, please don't hesitate to reach out to us on GitHub or on Discord.

Good bye Node 4 & welcome JSDOM 11​

Цього релізу ми припиняємо підтримку Node 4, головним чином тому, що завершує їх підтримку одна з наших головних залежностей JSDOM. Jest now comes out of the box with JSDOM 11 which features better support for SVGs, requestAnimationFrame, URL and URLSearchParams built in, and much more.

Custom Runners + Easy parallelization with jest-worker​

В Jest 21 ми представили концепцію користувацьких виконавців Jest. Since then, Rogelio, one of Jest's core contributors, built a number of useful runners: If you have many existing tests written using another framework but you'd like to immediately benefit from Jest's features, check out jest-runner-mocha. If you have a large codebase that needs linting, you may get a significant speedup if you run eslint within Jest using jest-runner-eslint.

Щоб отримати глибинний контроль над важкими завданнями паралелізації (наприклад, перетворення файлів або спостереження за файловою системою), ми розробили нову відповідну бібліотеку. We developed a modern, Promise-based module with an approachable API, called jest-worker, that allows you to delegate to child processes those intensive functions. As jest-worker, like any other Jest package, is a part of the Jest platform, you can use it however you like even without ever using Jest itself. You'll find more in the documentation here.

To get a better understanding of custom runners and Jest as a platform, make sure to check out Rogelio's talk from Reactive Conf 2017: Jest as a Platform.

Код фрейму в тестових помилках​

Щоб легше визначити, яке твердження є провальним для вашого тесту, ми додали код фрейму, який показує твердження, що має допомогти сфокусуватися на вашому коді. Приклад тесту:

test('some test', () => {
  function someFunctionWhichShouldThrow() {
    if (false) {
      throw new Error();
    }

    return 'success!';
  }

  expect(someFunctionWhichShouldThrow).toThrow();
});

В Jest 21, ми виводили наступну помилку:

В Jest 22, ми додали код фрейму, який дає більше контексту провальному твердженню. Ми також очистили стекові сліди, частково прибравши безлад.

Полегшене тестування помилок в асинхронному коді​

You can now use toThrow and toThrowErrorMatchingSnapshot on promise rejections in the same way you can on synchronous errors.

async function throwingFunction() {
  throw new Error('This failed');
}

test('asynchronous rejection', async () => {
  await expect(throwingFunction()).rejects.toThrowErrorMatchingSnapshot();
});

Асинхронні тестові середовища​

When Puppeteer, a way of programmatically interacting with a real Chromium Browser, was announced by the Google Chrome team in August, many wanted to be able to use Jest to write their tests running them in Chrome. Спільнота допомогла нам зробити це можливим завдяки асинхронному тестовому середовищу. We are still working on making this experience as good as possible, but please see this guide for how to use Puppeteer with Jest, starting today.

Експериментальна діагностика витоку​

We added an experimental --detectLeaks setting to Jest that will let you know if your internal environment instance is leaked after a test execution. Також буде попередження, коли ваш набір тестів вимагає файл після завершення тесту; це означає, що ви не дочекались всіх асинхронних операцій або залишили щось, що не було належним чином очищено. This will however not discover leaks in user land code, only in test land code; although the technology used behind it can help you (see jest-leak-detector). If you are reporting a bug about Jest's memory usage, please provide a repro where --detectLeaks will make the test suite fail. We started building a better sandboxing mechanism for Jest but it's not ready yet to be enabled by default. Якщо ви хотіли б допомогти, будь ласка, зв'яжіться з нами через discord!

Покращення режиму спостереження​

When using watch mode, there is now a way to focus only on tests that previously failed. В цьому режимі Jest не буде повторно запускати успішні тести, що повинно допомогти вам усунути всі проблеми в тестах. Additionally, we added a plugin system to watch mode. By adding modules to watchPlugins in your configuration you can extend the features of the watch mode.

Підтримка Babel 7​

Jest використовує Babel, щоб робити покриття коду та покращені функції імітації. Jest 22 також підтримує майбутній Babel 7. You'll find more in the documentation here.

Вдосконалення функцій-імітацій​

Jest 22 вносить декілька змін в функції-імітації, що робить їх ще простішими. Firstly, we added a mockName property allowing you to name your mocks, which is useful in assertion failures. We have also made the Jest mock function serializable in pretty-format, meaning that you can snapshot test mocks. In Jest 21, expect(jest.fn()).toMatchSnapshot() would serialize to [Function], in Jest 22, you might get something like this:

test('my mocking test', () => {
  const mock = jest.fn().mockName('myMock');

  mock('hello', {foo: 'bar'});

  expect(mock).toMatchSnapshot();
});

// Serializes to:

exports[`my mocking test 1`] = `
[MockFunction myMock] {
  "calls": Array [
    Array [
      "hello",
      Object {
        "foo": "bar",
      },
    ],
  ],
}
`;

Деталі Jest 21​

Jest 21 був випущений у вересні, і ми, на жаль, не випустили відповідний допис. Тож тримайте короткий огляд основних змін версії 21:

1. Use expect and jest-mock in the browser: Michael Jackson donated his excellent expect package to the Jest project. As part of that transition, the Jest core team, with much help from Kenneth Skovhus, made both jest-matchers (renamed to expect) and jest-mock work in browsers. This means that while you cannot use Jest itself in browsers (yet), you can use its awesome assertions and mocks for instance as replacements for Chai and Sinon running in Mocha tests. If you are migrating from earlier expect to the new Jest-powered expect, you can use jest-codemods to automate the migration.
2. MIT License: We changed Jest's license to MIT. Yay!
3. Fail test suites on async errors: Jest used to have a bug that made it crash when errors were thrown in certain parts of async code. Це було виправлено розробниками спільноти.
4. Faster startup: With Jest 21 we fine tuned Jest's startup to be more than 50% faster. Для малих тестів завжди були проблемою великі витрати часу Jest, але тепер це не має стримувати вас від використання Jest.

Jest Community​

Спільнота Jest тяжко працює, щоб забезпечувати ще кращий досвід тестування. Це окремі проєкти від основного Jest, але ми хочемо виділити деяких наших особистих улюбленців.

• jest-image-snapshot – custom matcher to compare images with snapshots by American Express developers
• ts-jest – all you need to successfully run Jest within TypeScript project by @kulshekhar
• jest-codemods – migrate your tests from other frameworks to Jest with ease
• jest-plugins – a new community project oriented around simplifying setting up test environment for specific tools, like React, or providing some handy utilities

We'd also like to announce that recently we launched a new place for high quality Jest additions – jest-community. It's a new GitHub organization already featuring our favorite projects, like vscode-jest, jest-extended, to name a few, curated by Jest maintainers and collaborators. We've even migrated our eslint-plugin-jest there, and already see some great contributions, which are published independently at a faster pace.

Спільні проєкти єдиної організації є чудовим способом експериментувати в таких речах, як автоматизований реліз, який ми б хотіли розглянути в контексті Jest. Вони також дають нам змогу вносити в них однакові речі, як то формат README (дякуємо спільноті webpack за ідею), спрощуючи їх вивчення та використання.

Якщо у вас є щось круте щоб поділитися, ви можете зв'язатися з нами! Ми були б раді розділити з вами ваш проєкт.

Multi-Project-Runner & Configuration Overhaul​

До сьогодні, Jest міг працювати лише в одному проєкті за раз. Це може перевантажувати процес, якщо ви працюєте над багатьма малими проєктами, кожен з яких має власні налаштування та конфігурацію. В Jest 20, ми повністю переписали виконавець тестів для одночасного запуску багато проєктів в одному екземплярі Jest; наприклад, якщо ви працюєте з фронтом React frontend і беком node.js. Here is a video of Jest running tests for React, Relay, Yarn and Jest all at the same time:

Наразі Jest згортає інструкцію використання після першого запуску тестів, щоб зберегти вертикальний простір в терміналі.

Також, ми повністю змінили спосіб роботи конфігураційної системи всередині Jest. Тепер ви можете передати будь-який параметр конфігурації через консоль для перезапису тих, що зазначені у вашому файлі конфігурації. Along with that, we changed Jest to look for a jest.config.js file by default which means you are now able to define a Jest configuration using JavaScript as well as being able to configure it through package.json like before. Після додавання всіх цих нових функцій, ви тепер можете поєднувати Jest ще більш дієвими способами. Наприклад, якщо ви хочете дізнатись, які тести з вказаного набору змінених файлів з декількох проєктів в монорепозиторії Jest буде запускати, ви можете поєднати аргументи командного рядка наступним чином:

$ jest --projects projectA projectB --listTests --findRelatedTests projectA/banana.js projectB/kiwi.js
[
  "projectA/banana.test.js",
  "projectB/kiwi.test.js",
  "projectB/pineapple.test.js",
]

Це особливо корисно для систем безперервної інтеграції (CI), де ви можете запустити лише підмножину тестів для запитів на злиття, аби запобігти виконанню тисячі тестів при кожній маленькій зміні.

Нарешті, тепер покриття коду зіставляється належним чином при використанні TypeScript; діє запуск неперевірених файлів у робочих процесах, що значно прискорює цю функцію.

New & Improved Testing APIs​

Ми зробили низку доповнень та вдосконалень до API тестів, що допоможе з написанням ефективніших тестів. Ми хотіли б зазначити, що всі ці вдосконалення були повністю зроблені членами спільноти!

• Better async testing: Added new async/Promise support through resolves/rejects modifiers on expect: expect(Promise(…)).resolves.toEqual(…). See documentation.
• Expect n assertions: Along with the existing expect.assertions(n), the new expect.hasAssertions() can be used to ensure a test has at least one assertion.
• Lint Plugin: A valid-expect rule was added to eslint-plugin-jest to ensure that an assertion is called after invoking expect. This will prevent mistakes like a stray expect(banana); with a missing assertion call.
• Pretty-Format Plugins: A number of new pretty-format plugins were added to Jest. We now pretty-print Immutable.js data structures and HtmlElements in assertion failures and snapshots.
• Custom Environment: It is now possible to add a @jest-environment node|jsdom annotation to the doc-block comment of a test file to use a test environment different from the default for individual tests.

Ось приклад того, як всі нові API разом покращують процес тестування:

/**
 * @jest-environment node
 */

test('compares apples and bananas', async () => {
  expect.hasAssertions(); // Ensure this test has at least one assertion.

  await expect(
    Promise.resolve(Immutable.Map({apples: 1, bananas: 2})),
  ).resolves.toEqual(Immutable.Map({apples: 1, bananas: 3}));

  expect('banana'); // valid-expect in eslint-plugin-jest will show an error.
});

Цей приклад виведе подібну помилку:

Важливі Зміни​

Як і в кожному великому релізі, ми здійснюємо ряд змін для внесення більших змін в майбутньому, а також для того, щоб вивести досвід тестування на новий рівень. Цього разу ми спробували зламати лише API, які не мають вплинути на більшості користувачів Jest:

• Fork of Jasmine 2.5: We finally decided to fork Jasmine itself and take ownership over Jest's own test runner. Це дозволить нам поліпшити усі аспекти досвіду модульного тестування у майбутньому, але зараз ми зосереджені на поступовому переписі та зменшенні API. If you see a test breaking as a result of a Jasmine API that is now missing, there should be an equivalent feature on the jest or expect objects. Ми видалили багато функцій, які зазвичай не використовуються в більшості баз коду.
• New Snapshots on CI: Snapshots must always be committed along with the test and the modules they are testing. We changed Jest to not save new snapshots automatically in Continuous Integration (CI) environments or when the --ci flag is specified. To overwrite this behavior, which is generally not recommended, the --updateSnapshot flag can be used.
• Babel-Polyfill: Jest used to load babel-polyfill automatically when using babel-jest which resulted in memory leaks inside of Jest. In most versions of node, it is not necessary to load babel-polyfill so we removed this auto-inclusion and instead changed Jest to only include regenerator-runtime by default, which is commonly used to support async/await in older versions of Node.js. If you need babel-polyfill, you can manually require it in your setup files.

Інші покращення​

• Documentation: Documentation is critical to share best practices and teach everyone how to write effective tests which will lead to better software. За останні кілька тижнів ми також розширили документацію Jest розділом Часті запитання щодо тестування знімками, керівництвом з інформацією про використання Jest з поширеними JavaScript бібліотеками, а також задокументованими новими функціями, описаними вище.
• Translations: We are now asking for your help to translate the Jest documentation to make it easier for people to learn how to use Jest.
• Custom Reporters: Jest now supports custom test reporters through the reporters configuration option. Ви нарешті можете налаштувати вивід Jest та інтегрувати його з іншими інструментами, генеруючи звіти в різних форматах, як-то XML. See documentation.
• Codebase Health: It was only possible iterate so quickly in Jest because we spent a significant amount of time on the health of the codebase. We were one of the early adopters of prettier, we notably increased flow coverage, forked Jasmine to improve our test runner library and we rewrote and refactored significant portions of Jest itself to set up Jest for success in the future.
• Bugfixes: As always, we made plenty of bugfixes in Jest. The full changelog can be found in the Jest repository.

Дискусії щодо Jest​

Останнім часом основна команда Jest та інші розробники почали більше розповідати про Jest та досвід роботи на конференціях:

• Rogelio Guzman did a talk about Jest Snapshots and Beyond at React Conf.
• I spoke about Building High-Quality JavaScript Tools at Facebook's F8 conference.

As always, this release couldn't have been possible without you, the JavaScript community. Ми безмежно вдячні за можливість покращувати тестування JavaScript разом з вами. If you'd like to contribute to Jest, please don't hesitate to reach out to us on GitHub or on Discord.

Поглиблений режим спостереження​

We completely rewrote the watch mode to make it instant and more extensible. В результаті, отримуємо поглиблений досвід використання: тести одразу перезапускаються після змін у файлі та ми полегшили вибір правильних тестів.

Оновлення знімків​

Ми зробили декілька змін у форматі знімку. Ми не вносимо такі зміни часто і розглядаємо їх додавання, лише якщо вони дійсно покращать роботу знімків. Так само як додавання номера версії знімку, ми акумулювали ряд змін, які ми вже деякий час хотіли внести до формату:

• We dropped the “test” prefix in snapshot names from top level test or it calls.
• Ми покращили вивід елементів React, аби отримувати менше змін при змінах властивостей елементу.
• Ми покращили механізм обходження символів для кращої захищеності.

До цього:

exports[`test snap 1`] = `
<header>
  <h1>
    Jest \"19\"
  </h1>
  <Subtitle
    name="Painless JavaScript Testing" />
</header>
`;

Після (немає префікса "test", кращий JSX рендеринг, заголовок версії):

// Jest Snapshot v1, https://goo.gl/fbAQLP

exports[`snap 1`] = `
<header>
  <h1>
    Jest "19"
  </h1>
  <Subtitle
    name="Painless JavaScript Testing"
  />
</header>
`;

Ми вирішили, що прийшов час ввести версії знімків, щоб гарантувати, що всі розробники використовують сумісні версії Jest. Ось як ми попереджаємо вас про необхідність оновлення вашого знімку:

Переконайтеся, що ви скасували всі локальні зміни перед оновленням, аби зробити перехід безпроблемним і переконатись, що жодні небажані зміни від провальних тестів не були додані в нові знімки.

Вдосконалений вивід пропущених тестів​

Пропущені тести виводяться єдиним рядком замість виводу кожного окремого тесту при тестуванні в детальному режимі або одному наборі. Сподіваємось, це дозволить вам сфокусуватися на важливих тестах. Також це займає значно менше простору!

Нові аргументи CLI​

Jest 19 публікується з двома новими аргументами покриття, які ви можете запустити з командного рядка:

• --collectCoverageFrom
• --coverageDirectory

Тепер ми також виводимо неприпустимі аргументи CLI, не ігноруючи їх. But we've got your back with helpful error message like the one below, e.g. when you try running jest --watc:

expect Improvements​

• expect.addSnapshotSerializer
• expect.stringContaining
• jest.spyOn

We're close to almost full feature parity with the expect npm package. Michael Jackson, the author of the package, agreed to donate it to the Jest project, which means that jest-matchers will be renamed to expect. Since our version of expect is not intended to be fully compatible, Christopher Chedeau is working on a codemod to make the transition painless. Christopher also worked on a number of improvements to jest-matchers which enables it to be used outside of Jest and even works inside browsers.

eslint-plugin-jest – our very own ESLint plugin​

Thanks to Jonathan Kim Jest finally has its own official ESLint plugin. Він містить три правила:

• no-disabled-tests - this rule prevents you from accidentally committing disabled tests.
• no-focused-tests - this rule prevents you from committing focused tests which would disable all other tests in the same suite.
• no-identical-title - disallows identical titles in test names.

You can install it using npm install --save-dev eslint-plugin-jest or yarn add --dev eslint eslint-plugin-jest and it can be enabled by adding {"plugins": ["jest"]} to your eslint configuration.

New public package: jest-validate​

Коли ми переробили код перевірки та нормалізації для конфігурації Jest, ми були настільки задоволені новими повідомленнями про помилки, що ми виділили його в окремий модуль, щоб поділитися з іншими. With Jest 19 we welcome jest-validate to our self-sustained packages family.

jest-validate is a generic configuration validation tool that helps you with warnings, errors and deprecation messages in your JavaScript tool. Він також здатен показувати зручні для користувачів приклади правильних налаштувань та надає простий, але потужний API. Сподіваємось, це стане гарним доповненням до ваших проєктів!

We're happy to announce that jest-validate is validating config options of prettier since v0.12. Додавайте його до свого проєкту, спробуйте, надішліть нам відгук та допомагайте з покращенням, роблячи запити на ухвалення змін на GitHub.

Вдосконалені асиметричні матчери​

Ми перемістили асиметричну реалізацію матчерів з Jasmine в Jest, що дало змогу надалі покращувати користувацький досвід. As a result, asymmetric matchers are now pretty-printed nicely, we added the new expect.stringContaining() matcher and we also paired them with expect.toMatchObject() so you can use the best of both:

Кращі ручні імітації​

З останнім релізом, ручні імітації нарешті працюють з вкладеними каталогами. For example __mocks__/react-native/Libraries/Text/Text.js will now work as expected and mock the correct module. We also fixed issues with virtual mocks and transitive dependencies and improved moduleNameMapper to not overwrite mocks when many patterns map to the same file.

Важливі Зміни​

As a part of our cleanups and fixes we removed the mocksPattern configuration option which was never officially supported. We also renamed the testPathDirs configuration option to roots which better explains what the option can be used for. The default configuration for roots is ["<rootDir>"] and can be customized to include any number of directories. Параметр конфігурації rootDir завжди використовувався в основному як маркер для інших параметрів, тож це перейменування має зробити процес налаштування Jest зрозумілішим.

Оновлена документація​

As you may have already seen, Hector Ramos and Kevin Lacker gave Jest's documentation a fresh new look. Ми змінили спосіб організації сайту, тепер Документація та API представлені окремими сторінками:

• Under Docs you can find an introduction to Jest, including Getting Started or Testing Asynchronous Code and handy guides like Snapshot Testing, Testing React Native App, Using with webpack or Migrating to Jest and many more!
• The API section on the other hand lists all available methods exposed by Jest: the expect and jest objects, mock functions, globals, along with configuration options from package.json and from the CLI.

The homepage was completely redesigned to be more descriptive of what Jest is about: “Zero configuration testing platform”. Ми також переконані, що новий вигляд зручніший для мобільних пристроїв. And for those using RSS – we finally provide a feed for our blog.

Оновлення спільноти​

• We really loved this talk: “Introduction to Jest“ by Vas Boroviak.
• Follow @jestjs_ on Twitter.
• Команда Jest Core збирається раз на тиждень, щоб обговорити поточні та майбутні проблеми. Якщо ви б хотіли працювати над Jest, надішліть нам декілька запитів на злиття і приєднуйтеся до наших щотижневих командних зустрічей.
• The awesome engineers at Artsy wrote about Jest as part of their 2017 frontend stack.
• Stephen Scott wrote a detailed article about testing React components in which he weighs the pros and cons of different approaches.
• Using Jest with vue.js got a lot easier after reading Cristian Carlesso's blog post.
• Michele Bertoli wrote a book about React Design Patterns and Best Practices which features an entire section about Jest.
• Improved --notify command that shows an operating system notification which can now also re-run tests from the notification. Насправді це просто функція Jest, ми просто перевіряємо, чи ви все ще читаєте цей допис.
• Jest is now part of react-boilerplate.
• Read about the hidden powers of Jest's matchers.

Finally, we are happy to announce that the ava test runner has adopted parts of the Jest platform and is now shipping with basic snapshot support and is using pretty-format. Об'єднання тестової інфраструктури спрощує вивчення тестування додатків і дає нам змогу ділитися найкращими практиками. Ми з нетерпінням очікуємо побачити, чого ми можемо навчитись з наявних тестових бібліотек в майбутньому.

The full changelog can be found on GitHub. Jest 19 was a true JavaScript community effort with 17 people who contributed to this release. Ми дякуємо кожному з вас за вашу допомогу в покращенні цього проєкту.

This blog post was written by Rogelio Guzman and Michał Pierzchała.

Покращені документи​

Одна з помітних змін - оновлена бічна панель. Документація тепер розподілена на три основні розділи: вступ до Jest, детальні посібники для функціонала та універсальна API довідка.

The Introduction section will guide you from installing Jest and writing your first case, to using Jest's matchers and testing async code. Якщо ви новачок в Jest або хочете швидко освіжити знання, ця частина швидко в цьому допоможе. If you've used Jest before and only need a quick reference on how it's installed, you need to go no further than the Getting Started guide.

Once you feel comfortable using Jest, proceed to the advanced Guides section. The new Snapshot Testing guide covers everything you need to know about creating and maintaining snapshot test cases.

Також, ми повністю змінили нашу документацію API. You can now find detailed information on all of Jest's Globals, matchers, and every flag supported by the jest CLI.

New colors & website​

Кольори логотипу та сайту Jest вже давно здавались нам застарілими. Ми змінили кольори теми, яку ми використовуємо для Jest і суттєво змінили основну сторінку, зробивши її більш привабливою. Ми сподіваємось, що вам подобаються нові кольори та приклад сильних сторін Jest.

Хто використовує Jest?​

We have created a showcase of users to highlight some of the companies that are using Jest. Ми вдячні усім цим компаніям за використання Jest для тестування власних вебсайтів, мобільних додатків та API. Якщо ви використовуєте Jest, перегляньте рекомендації на GitHub і надішліть нам свої запити на ухвалення змін!

Jest в браузері​

As highlighted last month, it is now possible to use Jest directly in the browser using repl.it. Якщо ви бажаєте спробувати Jest перед встановленням, ви можете легко зробити це нижче або безпосередньо з головної сторінки Jest. Спробуйте!

Як долучитись​

Це лише початок. Перегляньте документацію та не соромтеся надіслати нам свій відгук. If you find a mistake in the docs or you just want to let us know what needs to be documented better, please tweet at us at @jestjs_, open an issue on GitHub, or send us a PR by clicking "Edit on GitHub" at the top of the doc.

Ми з нетерпінням чекаємо наступний рік та раді чути вас!

The newly created react-test-renderer finally enabled testing of react-native components. Through the jest-react-native preset (now merged directly into react-native) Jest now works out of the box for any React project and comes pre-configured in create-react-app and react-native projects. We integrated core pieces of Jest into react-native's packager and the completely new snapshot testing feature has since been used outside of Jest: It was integrated with React Storybook as “storyshots” and is being adopted by other test runners like ava.

The pretty-format project was rewritten with performance in mind to drive Jest's snapshot feature, was recently merged into Jest's monorepo and is also helpful in other test runners. На цей момент Jest презентує збірник різних ідей та рішень для тестування, а не єдину конкретну реалізацію тестового фреймворку.

I'd like to deeply thank all the people that have contributed to Jest this year, both from the open source community and at Facebook: Dmitrii Abramov, Cristian Carlesso, Dan Abramov, Daniel Lo Nigro, Maxim Derbin, Evan Scott, Forbes Lindesay, Keyan Zhang and 60 more people. We'd also like to welcome Michał Pierzchała (@thymikee) as first official external contributor to Jest. Він провів чудову роботу з управління проблемами та PR-ами репозиторію. If you'd like to start contributing to Jest, we have a bunch of good first tasks and we are always happy to help on our discord channel.

repl.it with Jest integration​

Amjad Massad built a Jest container so you can now try out Jest directly in the browser. З цього моменту, ви можете використовувати його при створенні проблем на GitHub, що має допомогти швидше розв'язувати проблеми. Amjad and Haya are building repl.it to democratize programming by building powerful yet simple tools and platforms for educators, learners, and developers. They are also hiring talented engineers!

Оновлення спільноти​

We feel incredibly humbled that 100+ companies have adopted Jest in the last six months. Такі компанії, як Twitter, Pinterest, Paypal, nytime, IBM (Watson), Spotify, eBay, SoundCloud, Intuit, FormidableLabs, Automattic, Trivago та Microsoft повністю або частково перейшли на Jest через потреби в тестуванні JavaScript. Ми вдячні за шанс, який ви дали цьому проєкту. Ми також хотіли б подякувати всім, хто відвідував конференції та зустрічі для презентації Jest і усім, хто створює дописи в блогах про власний досвід з Jest!

Ось що сталося у спільноті за останні два місяці:

• Jason Bonta and Dmitrii Abramov redefined the “testing pyramid” we were talking a lot about at Facebook.
• jest-codemods now allows you to painlessly migrate from Mocha, Tape and Ava to Jest.
• The React team announced improvements to the react-test-renderer in 15.4.0.
• Orta Therox build an amazing vscode-jest integration and donated the code for editor support to Jest.
• Pavithra Kodmad is documenting Flipkarts adoption of Jest and shares some getting started tips.
• Kent C. Dodds wrote about migrating to Jest at Paypal and Jason Brown wrote about migrating to Jest as well.
• Ben McCormick wrote about saving time with Jest.
• Eric Clemmons wrote about snapshots and storybook integration.
• Edvin Erikson wrote about getting Tap output in Jest.
• jest-html can bring snapshot diffing to your browser.
• There were a few great conversations on hackernews about Jest.
• The community started a great discussion about the future of enzyme.
• Ruben Oostinga wrote about combining chai and Jest matchers.
• Emil Ong wrote about why “TDD'ing your frontend seems pointless”.
• Nate Hunzaker wrote about end-to-end testing with Jest and Nightmare.
• Using Jest with Angular just works according to Matthieu Lux.
• A fantastic conversation about the purpose of snapshot testing is happening right now.
• Dmitrii made a new music video with his metal band.
• lazyspec can help you create smoke tests quickly if you are introducing tests to an existing codebase.
• Patrick Stapfer did a lightning talk about vim and Jest.
• Mark Dalgleish was commenting on the value of snapshot testing.

New features, changes and fixes in Jest 17 & 18​

Jest був створений понад п'ять років тому, тож, як старий фреймворк, він накопичив технічний борг. Ось чому ми рішуче робимо великі зміни частіше, ніж може здатися необхідним: ми вважаємо за потрібне поступово зменшувати технічний борг, аби забезпечити Jest повноцінною довгостроковою підтримкою. We didn't announce Jest 17 in a blog post and if you haven't upgraded to it in the last month you may find the changelog useful.

• Breaking: Removed pit in favor of it or test and mockImpl in favor of jest.fn() or mockImplementation .
• Breaking: Renamed --jsonOutputFile to --outputFile.
• Breaking: Updated testRegex to include test.js and spec.js files.
• Breaking: Replaced scriptPreprocessor with the new transform option.
• Breaking: The testResultsProcessor function is now required to return the modified results.
• Potentially Breaking: Properly resolve snapshotSerializers, setupFiles, transform, testRunner and testResultsProcessor with a resolution algorithm instead of using path.resolve. This mainly means that <rootDir> is no longer needed for these options.
• Added: pretty-format and jest-editor-support were merged into Jest.
• Added: expect.any, expect.anything, expect.objectContaining, expect.arrayContaining, expect.stringMatching.
• Added: --testResultsProcessor is now exposed through the cli.
• Added: Implemented file watching in jest-haste-map.
• Added: Usage of Jest in watch mode can be hidden through JEST_HIDE_USAGE.
• Added: expect.assertions(number) which will ensure that a specified amount of assertions is made in one test.
• Added: .toMatchSnapshot(?string) feature to give snapshots a name.
• Added: toMatchObject, toHaveProperty , toHaveLength matchers.
• Added: expect.extend.
• Added: Added support for custom snapshots serializers.
• Added: Big diffs are now collapsed by default in snapshots and assertions. Added --expand (or -e) to show the full diff.
• Added: jest.resetAllMocks which replaces jest.clearAllMocks.
• Added: --json now includes information about individual tests inside a file.
• Fixed: test.concurrent unhandled promise rejections.
• Fixed: babel-plugin-jest-hoist when using jest.mock with three arguments.
• Fixed: The JSON global in jest-environment-node now comes from the vm context instead of the parent context.
• Fixed: Jest does not print stack traces from babel any longer.
• Fixed: Fake timers are reset when FakeTimers.useTimers() is called.
• Fixed: Regular expressions are properly escaped in snapshots.
• Fixed: Improved pretty printing of large objects.
• Fixed: NaN% Failed in the OS notification when using --notify.
• Fixed: The first test run without cached timings will now use separate processes instead of running in band.
• Fixed: Map/Set comparisons.
• Fixed: test.concurrent now works with --testNamePattern.
• Fixed: Improved .toContain matcher.
• Fixed: Properly resolve modules with platform extensions on react-native.
• Fixed: global built in objects in jest-environment-node now work properly.
• Fixed: Create mock objects in the vm context instead of the parent context.
• Fixed: .babelrc is now part of the transform cache key in babel-jest.
• Fixed: docblock parsing with haste modules.
• Fixed: Exit with the proper code when the coverage threshold is not reached.
• Fixed: Jest now clears the entire scrollback in watch mode.
• Deprecated: jest-react-native was deprecated and now forwards react-native.

Плани Jest на першу половину 2017​

Six months ago we shared our plans for Jest and we are happy that we were able to execute well on almost all of them. Наші плани на наступні шість місяців:

• Instant feedback: Nuclide integration and an improved and faster watch mode.
• Improved developer experience: new mocking APIs and improved assertions.
• Better performance and memory usage: analyze Jest and be more conscious about efficiency.
• Snapshot Improvements: snapshot approval mode, syntax highlighting and improved react-test-renderer APIs.
• Website: We'll overhaul the website and documentation and add a Jest cheat sheet.

Ми не надаватимемо графіків та розрахунків для цих нововведень, може так статись, що не все вдасться реалізувати. Якщо ви хочете допомогти з реалізацією, надішліть нам задачі та запроси на злиття з вашими ідеями; працюватимемо над покращенням Jest у 2017 році разом.

Оновлений CLI​

Jest 16 включає новий інтерфейс генератора звітів, який показує запущені тести, а також оновлюваний підсумок і смугу прогресу на основі розрахункового часу виконання з попередніх запусків. Ми також покращили вивід CLI для кращої роботи з різними кольоровими схемами. Якщо в попередньому виконанні в тестах були помилки, нині Jest буде запускати ці тести першими, щоб якомога швидше надати корисні дані користувачам.

Також ми додали безліч нових функцій, які вам можуть знадобитись:

• New CLI flags were added: A --testNamePattern=pattern or -t <pattern> option was added to filter tests from the command line much like it.only or fit does in tests.
• Попередньо провальні тести тепер завжди виконуються першими.
• jest <pattern> is now case-insensitive to make it easier to filter test files.
• Запуск тестів у режимі спостереження тепер можна переривати. During a test run, simply press any of the keys used for input during watch mode (a, o, p, q or enter) to abort a test run and start a new one.
• The --bail flag now also works in watch mode. Враховуючи першочерговий запуск попередньо невдалих тестів, режим спостерігання Jest буде відчуватись надмоторним!
• Jest now automatically considers files and tests with the jsx extension.
• Jest попереджає про повторні ручні файли імітацій та ми вдосконалили автоматично створені імітації для ES модулів, скомпільованих за допомогою babel.
• A jest.clearAllMocks function was added to clear all mocks in between tests.
• We improved module resolution when moduleNameMapper is used.
• Finally, a --findRelatedTests <fileA> <fileB> cli option was added to run tests related to the specified files. Це особливо корисно як хук перед комітом, якщо ви хочете запустити тести лише з вказаних файлів з відповідними тестами.

This is what Jest looks like when a test run is interrupted in watch mode:

Оновлення знімків​

Реалізація знімків Jest була повністю переписана. The new version of the jest-snapshot package is now structured in a way that allows for easier integration into other test runners and enables more cool integrations like with React Storybook. Jest не позначає знімки як застарілі в файлі з пропущеними або помилковими тестами. Ми також зробили ряд змін у форматі знімку:

• Об'єкти та масиви друкуються з комами в кінці, щоб мінімізувати майбутні зміни знімків.
• Ми видалили імена функцій зі знімків. Вони спричиняли проблеми з різними версіями Node, з інструментарієм покриття коду; ми, як правило, вважали, що зміна імені функції не входить до корисних даних для показу користувачеві.
• Знімки сортуються в звичайному порядку сортування всередині файлі.

When upgrading to Jest 16, the diff might look similar to this one:

Оновлення тестових бібліотек​

Ми завершили міграцію тверджень з Jasmine в нові матчери Jest. We added three new matchers: toBeInstanceOf, toContainEqual and toThrowErrorMatchingSnapshot . We have more readable failure messages for the spy/mock matchers toHaveBeenLastCalledWith, toHaveBeenCalledWith, lastCalledWith and toBeCalledWith. Тепер, коли ми переписали всі твердження та розділили їх в окремі пакети, ми будемо працювати над тим, щоб зробити їх автономними, щоб вони могли бути інтегровані в будь-який тестовий фреймворк, якщо ви хочете використовувати їх поза Jest.

Також на прохання спільноти було додано нові псевдоніми. To make Jest focus on a single test you can now use either it.only or test.only or keep using fit; For skipping a test, it.skip or test.skip are now available alongside of xit; finally to define a test as concurrent you can use test.concurrent which is useful in case your test accesses network resources or databases.

Finally, if you'd like to overwrite the expect global with a different assertion library like chai, this can now be done using the setupTestFrameworkScriptFile configuration option.

Оновлення спільноти​

За останній місяць було написано багато статей про функцію тестування знімками Jest, як мігрувати до Jest і як почати писати тести. Також я провів декілька відео стрімів, щоб пояснити, як працюють Jest та тестування знімками:

• FB Live Video about Snapshot Testing.
• JavaScript & React Testing with Kent C. Dodds.

Багато людей написали статті про тестування знімками. The most opinionated article that resonated with the Jest team was “Testing with Jest Snapshots: First Impressions”. У своєму дописі, Ben відмітив три чудових моменти:

1. Тестування знімками є доповненням для звичайних тестів, а не заміною.
2. Тестування знімками є кориснішим в поєднанні зі здорових процесом перевірки коду.
3. Тестування знімками добре співпрацює з автоімітацією.

Ми дуже рекомендуємо прочитати весь допис у блозі. Ben провів фантастичну роботу, пояснюючи причини, через які ми створили тестування знімками. Важливо відзначити, що ми не впроваджували тестування знімками на заміну всіх інших форм тестування, а скоріш як спосіб залучити розробників до написання тестів, які вони в іншому випадку не написали б. Воно добре працює для таких речей, як React компоненти, вивід командного рядка, повідомлення про помилки та багато інших, але не вирішує всіх проблем. Мета Jest - надати багато різних способів написання ефективних тестів без погіршення продуктивності чи простоти підтримки проєкту.

Інші пункти по тестуванню знімками:

• A React Native testing series: Part 1: Jest – Snapshot come into play and Part 2: Jest – Redux Snapshots for your Actions and Reducers.
• How we landed on Jest snapshot testing for JavaScript.
• Picture This: Snapshot Testing.
• Snapshot testing with React Storybook.
• Testing React and Redux Applications.
• If you are using the popular enzyme testing utility, there is now a project enzyme-to-json which makes it possible to use Jest's snapshot testing feature together with enzyme.

Redux itself now uses Jest and Max Stoiber wrote a tutorial on how to test code written with redux. There is also a great guide on how to write tests for MobX. If you are using create-react-app, Jest is now included by default. Kent C. Dodds created a ton of videos on egghead.io that will help you get started with Jest.

If you are using other test runners, Kenneth Skovhus built an awesome jest-codemods library that will automate the conversion for you. Codemods прекрасні: вони дозволять вам швидко оцінити, чи буде Jest працювати у вашому випадку. Спробуйте!

The full changelog can be found on GitHub. Jest 16 це дійсно результат зусиль спільноти JavaScript і проєкт зараз налічує понад 220 учасників. Ми дякуємо кожному з вас за вашу допомогу в покращенні цього проєкту.

The most important change to talk about is a set of new defaults. Якщо ви вже користуєтесь Jest, то, швидше за все, вам знадобиться оновити вашу конфігурацію для Jest 15. У більшості випадків налаштування спроститься та Jest надасть корисні повідомлення про помилки під час оновлення. Всі нові значення за замовчуванням можуть бути відключені відповідно до ваших потреб, але ми все ще вважаємо відключені функції критичними для Jest в певних ситуаціях, тож надалі довгостроково використовуватимемо та підтримуватимемо їх для Facebook. Our API documentation was also completely rewritten to reflect these changes. This pull request for React highlights some of the changes necessary for existing projects.

Нові повідомлення про помилки та підсумок CLI​

В процесі поступового видалення Jasmine з Jest, майже завершено заміну всі матчерів Jasmine. Багато часу було витрачено на налаштування кожного повідомлення про помилку, аби кожен матчер якнайкраще сигналізував падіння тестів - момент, коли Jest є найбільш важливим. In addition to printing the expected and received values, a diff is printed for the toBe and toEqual matchers to help spot mistakes. Додано більше кольорів, відповідні файли зі стеку більш виділяються.

Here is a comparison of the before and after on a light terminal: It also works well with darker colors:

Нова команда watch​

We completely rewrote jest --watch to be more interactive. It can now switch between running all tests or only test files related to changed files by pressing a or o. By pressing p a prompt appears that allows to specify a test pattern to focus on a specific set of files. Snapshot tests can be updated by pressing u.

Вдосконалення jest-react-native​

Mocks for ListView, TextInput, ActivityIndicator, ScrollView and more were added. Наявні імітації були оновлені для використання реальних реалізацій, тож наявні знімки, ймовірно, повинні бути оновлені при оновленні до Jest 15. A mockComponent function was added to jest-react-native that can be used to mock native components:

jest.mock('MyNativeComponent', () => {
  const jestReactNative = require('jest-react-native');
  return jestReactNative.mockComponent('MyNativeComponent');
});

Також додалось багато покращень імітацій зображень, модулю fetch та інших вбудованих API.

Буферизовані повідомлення консолі​

Jest розпаралелює запуски тестів між робочими процесами, щоб підвищити продуктивність. Раніше Jest пересилав консольні повідомлення з робочих процесів батьківським об'єктам і виводив їх негайно. При виконанні декількох тестів одночасно, часто було важко дізнатись, який тест в якому модулі викликав функцію журналу. У Jest 15, всі повідомлення консолі буферизуються та виводяться разом з результатами окремих тестів. Також виводяться файл та номер рядка виклику журналу, аби код можна було легко перевірити.

Compare the output of the previous version of Jest and Jest 15:

Автоматична імітація вимкнена​

Наразі у Jest автоматичну імітацію вимкнено за замовчуванням. Ця функція найбільше плутає нових користувачів і в більшості не має сенсу для малих проєктів. Ми ввели автоімітацію у Facebook і для нас вона чудово працювала, коли впроваджувалось модульне тестування великої існуючої бази коду з небагатьма існуючими тестами, але з часом стало здаватись, нібито люди витрачали більше часу на проблеми імітованиї/неімітованих модулів, ніж витратилось би на звичайне написання тесту. Також ми помітили, що автори бібліотек часто вимагають великої кількості основних модулів, які завжди мають бути вручну виставлені як неімітовані. Навіть щодо самого Jest ми усвідомили, що більшість тестів відключають автоімітацію вручну. Ми все ще вважаємо, що явна автоімітація може бути надзвичайно корисною. This change simply trades implicit mocks for explicit mocks via calls to jest.mock(moduleName).

If you would still like to use automocking by default, enable the automock setting in your configuration or manually call jest.enableAutomock() in your test or setup file.

Шаблони тестових файлів​

Not everyone uses the same convention of using a __tests__ folder to store tests. Jest 15 also looks for files ending in .spec.js or .test.js, two popular community standards. Jest 15 also removes the testDirectoryName and testFileExtensions configuration options and asks users to switch to the testRegex option when the old configuration options are used.

Постійність реєстру модулів​

Jest used to implicitly reset all modules before each test and we recommended requiring modules in beforeEach or inside of tests. Це корисно, якщо модулі мають локальний стан, який не повинен поширюватися між тестами. However, two big shifts happened: ES modules with the top-level import syntax and a renewed interest in writing stateless functional modules.

Це призвело до численних несумісностей. Ми також помітили, що в Facebook неявне очищення навіть не використовується. Instead we relied on explicit calls to jest.resetModules() which puts engineers in control on when to wipe away all state.

До прикладу:

const React1 = require('react');
jest.resetModules();
const React2 = require('react');

React1 !== React2; // Дві окремі копії React.

The call to resetModules wipes away the require cache. Другий виклик того самого модулю призведе до створення нових екземплярів модуля та всіх його залежностей. This feature is especially useful when dealing with modules that have side effects, like jest-haste-map.

Ми вважаємо, що краще передати контроль користувачам, тож ми вимкнули неявне очищення. Modules can be reset using jest.resetModules() in code and the resetModules option can be enabled in the configuration to bring back the previous behavior.

Справжні або імітовані таймери​

By default Jest used to mock all timer functions like setTimeout or process.nextTick and provided an API jest.runAllTimers() to advance timers programmatically. Це корисно, коли частина коду встановлює довгий тайм-аут, на який ми не хочемо чекати в тесті.

Однак ми дізналися, що більшість випадків застосування є доволі ізольованими. Async programming has also become much simpler in our test runner. Наразі Jest використовує реальні таймери за замовчуванням.

You can still override this by specifying "timers": "fake" in the configuration or by calling jest.useRealTimers() and jest.useFakeTimers() global switches.

setupEnvScriptFile vs setupFiles​

The setupEnvScriptFile configuration option has been deprecated for a while. Jest 15 removes it completely and replaces it with setupFiles. Цей параметр очікує масив шляхів файлів, завантажених перед виконанням тестового файлу.

Підтримка покриття переписаного коду​

Code coverage in Jest can be used through jest --coverage and requires no additional packages or configuration. Code coverage support was completely rewritten and a new collectCoverageFrom option was added to collect code coverage information from entire projects, including untested files. Зверніть увагу, що ця опція використовує шаблони пошуку файлів, бо в майбутньому ми сподіваємося ще більше спростити параметри конфігурації та надати простішу альтернативу регулярним виразам. See Jest's package.json for an example.

Інші покращення​

Також зроблено велику кількість інших покращень:

• Покращено продуктивність виконання невеликих тестів.
• Jest почав використовувати детальний режим при виконанні єдиного тестового файлу.
• Added an --env option to override the configured test environment.
• moduleNameMapper now uses a resolution algorithm.
• Jest тепер працює зі шляхами, в яких наявні спеціальні символи; наприклад, дужки.
• Added global.global to the node environment.
• Fixed babel-plugin-jest-hoist's invalid error when a random user function was called mock.
• Fix testEnvironment resolution to prefer jest-environment-{name} instead of {name} only. This prevents a module collision when using jsdom as test environment.
• Покращено власні тести Jest шляхом об'єднання інтеграційних і модульних тестів. Покриття коду тепер збирається для Jest.

Ми задоволені всіма змінами, які було зроблено разом з допомогою спільноти, а також з нетерпінням очікуємо наступні кілька місяців, аби зробити Jest ще кращим. Please file an issue if something isn't working as expected and send us pull requests.

Next up: Concurrent Reporter.

Одне зі значних відкритих питань полягало в тому, як ефективно писати тести React. There are plenty of tools such as ReactTestUtils and enzyme. Обидва інструменти чудові й активно використовуються. Однак від розробників часто чулось, що вони витрачають більше часу на написання тесту, ніж самого компоненту. В результаті, багато людей взагалі припинили писати тести, що врешті-решт призвело до нестабільності. Розробники пояснили нам: все, чого вони хотіли - це переконатися, що їхні компоненти не змінюються несподівано.

Разом з командою React, ми створили новий відтворювач тестів для React та додали тестування знімками в Jest. Consider this example test for a simple Link component:

import renderer from 'react-test-renderer';
test('Link renders correctly', () => {
  const tree = renderer
    .create(<Link page="http://www.facebook.com">Facebook</Link>)
    .toJSON();
  expect(tree).toMatchSnapshot();
});

The first time this test is run, Jest creates a snapshot file that looks like this:

exports[`Link renders correctly 1`] = `
<a
  className="normal"
  href="http://www.facebook.com"
  onMouseEnter={[Function bound _onMouseEnter]}
  onMouseLeave={[Function bound _onMouseLeave]}>
  Facebook
</a>
`;

Знімок варто додавати в систему контролю версій разом зі змінами коду. We use pretty-format to make snapshots human-readable during code review. Під час наступних запусків теста Jest просто порівняє результат роботи компонента зі збереженим знімком. Якщо вони співпадуть, тест пройде. If they don't match, either the implementation has changed and the snapshot needs to be updated with jest -u, or the test runner found a bug in your code that should be fixed.

Якщо ми змінимо адресу, на яку в нашому прикладі вказує компонент Link, Jest виведе на екран:

Now you know that you either need to accept the changes with jest -u, or fix the component if the changes were unintentional. To try out this functionality, please clone the snapshot example, modify the Link component and run Jest. We updated the React Tutorial with a new guide for snapshot testing.

This feature was built by Ben Alpert and Cristian Carlesso.

Експериментальна підтримка React Native​

Створивши відтворювач тестів, який не націлений на конкретну платформу, ми нарешті мали змогу підтримувати повну, не імітовану версію React Native. We are excited to launch experimental React Native support for Jest through the jest-react-native package.

You can start using Jest with react-native by running yarn add --dev jest-react-native and by adding the preset to your Jest configuration:

"jest": {
  "preset": "jest-react-native"
}

• Tutorial and setup guide
• Example project
• Example pull request for snowflake, a popular react-native open source library.

Чому тестування знімками?​

Для глобальних програм Facebook ми використовуємо систему під назвою "тестування знімками": тестову систему, що відтворює UI компоненти, робить знімок і згодом порівнює записаний знімок зі змінами, зробленими розробниками. Якщо знімки не збігаються, є два варіанти: зміни є неочікуваними або знімок можна оновити згідно з новою версією UI компонента.

Хоча це було бажане рішення для вебдодатків, ми також знайшли багато проблем системних тестів, які вирішуються тестами з інтеграцією знімків:

• No flakiness: Because tests are run in a command line runner instead of a real browser or on a real phone, the test runner doesn't have to wait for builds, spawn browsers, load a page and drive the UI to get a component into the expected state which tends to be flaky and the test results become noisy.
• Fast iteration speed: Engineers want to get results in less than a second rather than waiting for minutes or even hours. Якщо тести запускаються не так швидко, як в більшості системних фреймворків, розробники взагалі їх не запускатимуть або ж не писатимуть в першу чергу.
• Debugging: It's easy to step into the code of an integration test in JS instead of trying to recreate the screenshot test scenario and debugging what happened in the visual diff.

Because we believe snapshot testing can be useful beyond Jest we split the feature into a jest-snapshot package. Ми раді співпрацювати зі спільнотою, щоб зробити її універсальнішою, аби її можна було використовувати з іншими виконавцями тестів, а також ділитися з ними концепціями та інфраструктурою.

Також, хотілося б навести цитату розробника Facebook, який описує як тестування знімками змінило його досвід модульного тестування:

“Один з найскладніших аспектів мого проєкту - синхронізоване зберігання вхідних і вихідних файлів для кожного тестового випадку. Кожна маленька зміна функціоналу може призвести до зміни всіх вихідних файлів. З тестуванням знімками мені не потрібні вихідні файли, Jest вільно створює знімки! Я можу просто перевіряти, як Jest оновлює знімки, замість внесення змін вручну.” – Kyle Davis working on fjs.

Що буде далі для Jest​

Recently Aaron Abramov has joined the Jest team full time to improve our unit and integration test infrastructure for Facebook's ads products. Протягом наступних кількох місяців команда Jest планує значні покращення в наступних сферах:

• Replace Jasmine: Jasmine is slowing us down and is not being very actively developed. Ми почали заміну всіх матчерів Jasmin та з нетерпінням очікуємо початку додавань нових функцій, аби видалити цю залежність.
• Code Coverage: When Jest was originally created, tools such as babel didn't exist. Наша підтримка покриття коду має купу крайніх випадків та не завжди працює належним чином. Ми переписуємо цей момент, щоб розв'язати поточні проблеми з покриттям.
• Developer Experience: This ranges from improving the setup process, the debugging experience to CLI improvements and more documentation.
• Mocking: The mocking system, especially around manual mocks, is not working well and is confusing. Ми сподіваємося зробити її більш строгою та зрозумілою.
• Performance: Further performance improvements especially for really large codebases are being worked on.

Як завжди, якщо у вас є питання або якщо ви готові допомогти, будь ласка, зв'яжіться з нами!

Проєкт Flow значно розвинувся всередині Facebook й успішно використовується в багатьох наших фреймворках і коді майже всіх наших продуктів. Екземпляри чудово розпаралелюються: процес йде файл за файлом, поки не типізовано достатню кількість бази коду. Потім, Flow надає реальні значення та описові інструкції великих змін. За допомогою цього, було виявлено багато крайніх випадків і помилок.

With the help of lerna, we continued to modularize the Jest project. With just a small update to the configuration, Flow and lerna now get along well with each other. Splitting up Jest into packages helped us rethink module boundaries and enabled us to ship useful packages standalone: The jest-runtime and jest-repl cli tools now allow you to run scripts in a sandboxed Jest environment, enabling you to run and debug your app from the command line. This is especially helpful for projects that use Facebook's @providesModule module convention. To get started, just install jest-repl and run it in the same folder you normally run your tests in! We also published a jest-changed-files package that finds changed files in version control for either git or hg, a common thing in developer tools.

Нові та покращені функції​

• Added a notification plugin that shows a test run notification when using --notify.
• Added a browser config option to properly resolve npm packages with a browser field in package.json if you are writing tests for client side apps.
• Удосконалено повідомлення "тестів не знайдено", яке тепер повідомляє, які тести були знайдені та як вони фільтрувались.
• Added jest.isMockFunction(jest.fn()) to test for mock functions.
• Поліпшено вивід тестового генератора звітів і додано підсумок тестового звіту помилок під час масового запуску тестів.
• Added support for mocking virtual modules through jest.mock('Module', implementation, {virtual: true}).
• Removed the .haste_cache folder. Jest тепер використовує тимчасове розташування файлів, якому операційна система надає перевагу.
• Додано тривалість окремих тестів у детальний режим.
• Додано можливість запису знімків в Jest. Щодо цієї функції, ми скоро опублікуємо окремий допис у блозі.

Finally, we have received a complete website redesign done by Matthew Johnston and added documentation for using Jest with webpack. Happy Jesting!