Aller au contenu principal

Jest 24¬†: ūüíÖ Actualisation, polissage, facilit√© d'utilisation de TypeScript

· 10 minutes de lecture

Aujourd'hui, nous sommes heureux de vous annoncer la prochaine version majeure de Jest - la version 24 ! Quatre mois se sont écoulés depuis la dernière version mineure, et huit mois depuis Jest 23. Cette mise à jour est donc importante, et chacun y trouvera son compte ! Parmi les points forts, citons la prise en charge intégrée de TypeScript par la mise à niveau des internes de Jest vers Babel 7, la correction de certains problèmes de longue date concernant l'absence de sortie de la console et les problèmes de performance lors du calcul de diffs importants, ainsi qu'un tout nouveau site Web étincelant. ✨

For a full list of all changes see the changelog.

Nouveau site web‚Äč

@orta a fourni une belle refonte du site web de Jest, qui a été implémenté par les membres de la communauté @montogeek et @brainkim.

L'objectif de la refonte était de mettre davantage en évidence ce qui rend Jest génial, et de dissocier l'idée que Jest est principalement un outil pour tester les applications React - vous pouvez utiliser Jest pour toutes sortes de projets et nous voulons que cela soit évident. You can read more about the ideas behind the redesign in this issue.

Prise en charge de TypeScript‚Äč

Nous avons mis √† jour Babel 7 en interne pour Jest 24, qui est fourni avec la prise en charge pour les projets TypeScript. Cela signifie que Jest peut supporter la transpilation de TypeScript hors de la bo√ģte, tant que vous configurez Babel pour l'utiliser avec @babel/preset-typescript. La prise en charge par d√©faut de TypeScript, similaire √† celle de Flow, pr√©sente un inconv√©nient¬†: Babel ne supprimera les annotations de type que pour rendre votre code valide en JavaScript. Il ne v√©rifiera pas votre code.

Bien que Jest prenne en charge Babel 7 depuis la version 22 publiée en décembre 2017, il a fallu utiliser un module passerelle afin de s'adapter à la prise en charge de Babel 6 par Jest. Dans Jest 24, nous avons entièrement migré vers Babel 7, avec l'aide précieuse du membre de la communauté @milesj. Cela signifie que la configuration est maintenant plus facile et que nous pouvons profiter des autres fonctionnalités de Babel 7, comme le chargement de la configuration et la transpilation automatique des modules. Assurez-vous de supprimer le babel-core@^7.0.0-bridge.0 car il n'est plus nécessaire maintenant.

Si vous voulez ex√©cuter des contr√īles de type pendant que vous testez, vous devez utiliser ts-jest. Vous devrez configurer le transformateur, car Jest applique par d√©faut Babel aux fichiers .ts (et .tsx). Alternativement, vous pouvez ex√©cuter tsc ou m√™me utiliser un ex√©cuteur Jest pour transpiler simultan√©ment votre TypeScript tout en ex√©cutant vos tests¬†! Consultez jest-runner-tsc pour plus d'informations.

Consultez les documentations pour plus de détails.

astuce

If you for whatever reason cannot upgrade to Babel 7, you can still use Jest 24 with babel@6 as long as you keep babel-jest at version 23.

test.todo‚Äč

Jest 23 had a change that made tests missing an implementation throw instead of being skipped. This change was made due to feedback that accidentally skipped tests were hard to discover and hard to track down. However, this change broke the workflow for quite a few developers who used the feature to sketch out which tests to write.

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('une entrée invalide doit être levée');

test.todo('les options manquantes doivent être normalisées');

test.todo

Messages d'assertion am√©lior√©s‚Äč

When tests fail, you need to make confident and correct decisions which changes are expected progress and which changes are unexpected regressions. It is especially important not to miss a few regressions hidden among much progress. Jest 24 makes reports when assertions fail more clear and concise for several matchers. Because the effort will continue in Jest 25, you might notice some temporary inconsistencies. If your tests never fail, then you won't get to see them - for the rest of us, it'll be easier to debug why something isn't working as expected. 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.

Examples:

Failing assertion

failing assertion

Type mismatch

different types

Mock function not called

mock functions

R√©paration de vieilles douleurs‚Äč

We've fixed a couple of really old issues in this release.

The first one we'd like to highlight is console.log statements going missing. Jest intercepts and collects all logs in order to give you a stack trace to them, as well as provide them to reporters so you can handle them however you want. However, this has led to an issue where they have simply been missing in certain edge cases. Luckily for Jest 24, @spion has stepped up and fixed this issue. Thank you very much!

The second one is an issue where Jest runs out of memory if the difference in serialization of expected and received value has a huge number of insertion changes (either unexpected because of mistake in test or defect in serializer or expected because of temporary failures during test-driven development). @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!

Autres faits marquants‚Äč

  • Nous avons √©galement apport√© quelques am√©liorations pour globalSetup et globalTeardown - la transformation du code leur sera appliqu√©e de mani√®re similaire √† setupFiles et ils sont d√©sormais pris en charge en tant que partie int√©grante des 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.
  • Une bizarrerie de la CLI de Jest a √©t√© que si certains drapeaux et options ont √©t√© ¬ę¬†camel cas√©s¬†¬Ľ (comme runInBand), d'autres ne l'ont pas √©t√© (comme no-cache). Dans Jest 24, les deux sont reconnus, ce qui signifie que vous pouvez √©crire vos arguments CLI comme vous le souhaitez.
  • Nous avons renomm√© setupTestFrameworkScriptFile en setupFilesAfterEnv, et nous l'avons converti en tableau. Nous esp√©rons que cela rendra les options plus claires. Nous avons pr√©vu de remanier encore la configuration dans la prochaine version majeure, voir le paragraphe dans la section ci-dessous.
  • Pour r√©duire la quantit√© de magie que Jest effectue pour ¬ę¬†juste fonctionner‚ĄĘ¬†¬Ľ, dans cette version nous avons d√©cid√© de laisser tomber l'injection automatique de regenerator-runtime, qui est parfois utilis√© dans le code async compil√©. L'inclusion de regenerator-runtime n'est pas toujours n√©cessaire et nous pensons que c'est √† l'utilisateur de l'inclure si c'est n√©cessaire. Si vous utilisez @babel/preset-env avec targets, d√©finissez une version moderne de Node (par exemple Node 6+) vous n'aurez pas besoin de l'inclure. Veuillez consulter nos docs de l'utilisation de Babel pour plus d'informations.
  • Node.js 10 a fourni un module exp√©rimental appel√© worker_threads, qui est similaire aux threads Worker dans le navigateur. jest-worker, une partie de la plateforme Jest, sera en mesure d'utiliser worker_threads s'il est disponible au lieu de child_process, ce qui le rend encore plus rapide¬†! Benchmarks show a 50% improvement. En raison de sa nature exp√©rimentale, il n'est pas activ√© lorsque vous utilisez Jest en tant qu'ex√©cuteur de test, mais vous pouvez l'utiliser dans vos propres projets aujourd'hui¬†! Nous pr√©voyons de l'activer par d√©faut lorsqu'il sera sorti du statut exp√©rimental dans Node.js.

Changements de rupture‚Äč

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

  • Nous avons fait une mise √† jour vers Micromatch 3. Bien que cela n'affecte pas tous les utilisateurs, cette version est plus stricte dans l'analyse des globs que la version 2, qui est utilis√©e dans Jest 23. Veuillez lire ce probl√®me et les issues li√©es pour des exemples de globs invalides au cas o√Ļ vous auriez des probl√®mes.
  • Nous avons supprim√© les restes de code qui √©taient n√©cessaires pour Node 4. Il √©tait auparavant techniquement possible d'ex√©cuter Jest 23 sur Node 4 - ce n'est plus possible sans polyfill et transpilation.
  • Quelques changements dans la s√©rialisation des fonctions simul√©es dans les snapshots - assurez-vous de v√©rifier vos snapshots mis √† jour apr√®s la mise √† jour de la version. Related PR.
  • Jest n'injecte plus automatiquement regenerator-runtime - si vous obtenez des erreurs √† ce sujet, assurez-vous de configurer Babel pour qu'il transpile correctement les fonctions async en utilisant par exemple @babel/preset-env. Related PR.

L'avenir‚Äč

We are incredibly humbled by the results in State Of JS 2018, where Jest won the ‚ÄúHighest Satisfaction‚ÄĚ award. Another huge thing to happen in 2018 was in October, when Jest passed 2 million weekly downloads for the first time. Thank you.

We are very thankful for the trust in us shown by the community, and hope to build on it in the future. We will ensure Jest 24 and future releases will continue to build upon this incredible foundation, and continue to be an integral part of JavaScript developers' toolkits.

This has been the first release where we have explored the idea of using our Open Collective funding to create bug bounties. 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. We'd like to do more, if you have a pet bug that's a good candidate for our bounty program, please let us know. In the meantime, you can find all the tickets with a bounty via the issue label.

We have already started to make plans for the next release of Jest 25, with the biggest planned feature being an overhaul of our configuration, which is pretty hard to grok, mainly because of overlapping option and mixing globs and regular expressions. Feedback on how you want Jest's configuration to look is very much welcome, and can be submitted in this issue.

You might also have heard that we are planning to migrate the code base from Flow to TypeScript. We are hopeful that this migration will enable even more contributors to jump in and help make 2019 even better for JavaScript testing. ūüöÄ The plan is to land this in a minor release in the not too distant future. 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. Feel free to reach out if you have any further questions about it. The video is available on our website.

Happy Jesting¬†! ūüÉŹ