Note du traducteur
C'est la traduction du fichier watch-mode.md. Voici un lien vers les différences avec le master de AVA (Si en cliquant sur le lien, vous ne trouvez pas le fichier watch-mode parmi les fichiers modifiés, vous pouvez donc en déduire que la traduction est à jour).
Traductions : English, Italiano, Русский, 简体中文
AVA est livré avec un mode watch intelligent. Il surveille les fichiers modifiés et exécute seulement les tests qui sont impactés.
Vous pouvez activer le mode watch en utilisant l'option --watch ou -w.
$ npx ava --watchVeuillez noter que le débogage intégré et le reporter TAP ne sont pas disponibles lors de l'utilisation du mode watch.
AVA utilise chokidar pour surveiller les fichiers. Notez que même si vous voyez des avertissements lors de l'installation sur les dépendances optionnelles, il fonctionnera correctement. Veuillez vous référer à la section Install Troubleshooting de la documentation de chokidar pour savoir comment résoudre les problèmes d'installation avec chokidar.
Par défaut AVA surveille les modifications de tous les fichiers, à l'exception de ceux avec une extension .snap.md, ava.config.* et des fichiers dans certains répertoires qui ont été fournis par le package ignore-by-default.
Vous pouvez configurer des patterns supplémentaires pour ignorer des fichiers dans la section ava de votre package.json ou le fichier ava.config.* en utilisant la clé ignoredByWatcher.
Si vos tests écrivent quelque chose sur le disque, ils peuvent déclencher le mode watch pour re-exécuter vos tests. La configuration de patterns supplémentaires pour ignorer permet d'éviter cela.
AVA surveille les fichiers source qui dépendent de vos fichiers de tests. Si vous modifiez une telle dépendance, seul le fichier de test qui en dépend pourra être ré-exécuter. AVA ré-exécutera tous les tests s'il n'arrive pas à déterminer quel est le fichier de test qui dépend du fichier source.
La surveillance de dépendance fonctionne pour les modules exigés (require). Les extensions et transpileurs personnalisés sont pris en charge, à condition que vous les ajoutiez dans votre package.json ou le fichier ava.config.* au lieu de le faire à l'intérieur de votre fichier de test. Les fichiers accessibles à l'aide du module fs ne sont pas surveillés.
.only désactive l'algorithme de suivi des dépendances du mode watch. Lorsqu'une modification est effectuée, tous les tests avec .only seront ré-exécutés, indépendamment du fait que le test dépend du fichier modifié.
Si vous exécutez AVA dans votre CI avec le mode watch, l'exécution s'arrêtera avec une erreur (Error : Watch mode is not available in CI, as it prevents AVA from terminating.). AVA ne s'exécutera pas avec l'option --watch (-w) dans le CI, car les processus du CI doivent se terminer et avec l'option --watch, AVA ne se terminera jamais.
Vous pouvez rapidement relancer tous les tests en tapant r sur la console, suivie par Entrée.
Vous pouvez mettre à jour les instantanés défaillants en tapant u sur la console, suivi par Entrée.
Parfois, le mode watch fait des choses surprenantes comme ré-exécuter tous les tests alors que vous pensiez qu'un seul test aurait été ré-exécuté. Pour voir son raisonnement, vous pouvez activer un mode de débogage. Cela fonctionne mieux avec le reporter verbose :
$ DEBUG=ava:watcher npx ava --watchLe mode watch est relativement jeune et il peut y avoir des petites erreurs. Veuillez signaler (en anglais) les problèmes que vous rencontrez. Merci !