Étendre les tests avec du texte fantôme et corriger les tests ayant échoué

Effectué

Une fois que votre projet de test contient quelques cas de test, GitHub Copilot pouvez vous aider à étendre la couverture et à résoudre les défaillances sans quitter Visual Studio Code. Les suggestions de texte fantôme ajoutent des cas de test supplémentaires dans le fichier que vous modifiez, tandis que l’Explorateur de tests et la /fixTestFailure commande de barre oblique vous aident à diagnostiquer et corriger les tests défaillants. Ensemble, ces fonctionnalités ferment la boucle sur le flux de travail de test unitaire que vous avez démarré dans la vue Conversation.

Étendre la couverture des tests avec des suggestions de texte fantôme

Le texte fantôme est la complétion de code en ligne qui apparaît au fur et à mesure que vous tapez dans l’éditeur. Lorsqu’un fichier de test contient déjà quelques cas de test, GitHub Copilot utilise les modèles existants pour suggérer des cas de test similaires pour des scénarios supplémentaires. Il s’agit du moyen le plus rapide d’étendre la couverture une fois que vos tests initiaux sont en place.

Pour étendre un fichier de test avec du texte fantôme :

1. Ouvrez un fichier de test qui contient au moins un ou deux cas de test complets.

2. Positionnez le curseur à la fin du dernier cas de test, puis appuyez sur Entrée pour démarrer une nouvelle ligne.

3. Commencez à taper une nouvelle méthode de test ou écrivez un commentaire descriptif tel que // Test that ProcessOrder throws when the order total is negative.

   GitHub Copilot affiche une suggestion de texte fantôme qui termine la méthode de test basée sur le code environnant, les importations et les modèles de test existants.

4. Appuyez sur Tab pour accepter la suggestion, ou appuyez sur Échap pour l’ignorer.

5. Affinez la suggestion acceptée en fonction des besoins. Vous pouvez continuer à taper pour étendre le test ou déclencher la suggestion de texte fantôme suivante en appuyant sur Entrée.

Le texte fantôme fonctionne mieux quand :

• Le fichier de test affiche déjà le modèle que vous souhaitez GitHub Copilot suivre (par exemple, Organiser-Act-Assert structure ou attribut de test paramétrable).
• La méthode sous test est référencée dans le fichier par le biais d’une directive ou d’un using espace de noms importé.
• Votre commentaire indique clairement le scénario que vous souhaitez tester.

Tip

Utilisez du texte fantôme pour ajouter rapidement des cas de périphérie à une classe de test existante. Pour des travaux plus importants, tels que la création d’une classe de test entièrement nouvelle, revenez à la vue Conversation et utilisez les agents Ask, Plan ou Agent.

Corriger l’échec des tests à partir de l’Explorateur de tests

Lorsqu’un test échoue, l’Explorateur de tests fournit un point d’entrée en un clic dans GitHub Copilot.

1. Exécutez vos tests depuis l’Explorateur de tests ou depuis le bouton vert de lecture à côté d’une méthode de test.

2. Dans l’Explorateur de tests, pointez sur un test défaillant.

3. Sélectionnez le bouton Corriger l’échec du test (icône sparkle).

   GitHub Copilot ouvre une session de conversation, attache le test défaillant et sa sortie en tant que contexte, et propose un correctif.

4. Passez en revue le correctif proposé.

   La suggestion peut mettre à jour le code de l’application, le code de test ou les deux, en fonction de la cause de l’échec.

5. Appliquez ou ignorez la suggestion.

   Utilisez Conserver pour appliquer les modifications suggérées ou utilisez Annuler pour les ignorer. Réexécutez le test pour confirmer le correctif.

Corriger les tests défaillants avec /fixTestFailure

Vous pouvez également démarrer le flux de travail de correction à partir de la vue Conversation, ce qui est utile lorsque vous souhaitez attacher un contexte supplémentaire ou lorsque vous utilisez plusieurs tests défaillants à la fois.

1. Ouvrez la vue Conversation.

2. Entrez la /fixTestFailure commande slash.

3. Si vous le souhaitez, attachez un contexte supplémentaire, tel que des fichiers sources associés ou une sortie de terminal récente.

4. Suivez les suggestions de GitHub Copilot pour corriger le test défaillant, puis réexécutez le test pour confirmer le correctif.

Laissez l’agent surveiller et corriger automatiquement les échecs

Lorsque vous utilisez l’Agent pour exécuter des tests, il surveille la sortie du test, identifie les échecs et tente automatiquement de corriger et de réexécuter les tests. Cela est utile lorsque vous créez une structure d’un nouveau projet de test ou que vous apportez des modifications importantes qui affectent plusieurs tests à la fois.

Pour utiliser l’agent pour la maintenance automatique des tests :

1. Ouvrez la vue Conversation et sélectionnez Agent dans le sélecteur d’agents.

2. Fournissez une invite qui inclut l’exécution des tests, par exemple : Run the xUnit tests in the Calculator.Tests project. If any tests fail, propose and apply fixes, then rerun the tests until they pass.

3. Confirmez ou refusez les appels d’outils et les commandes de terminal que l’Agent suggère.

4. Passez en revue les modifications appliquées à l’Agent avant de les accepter.

Choisir l’outil approprié pour le travail

Utilisez les conseils suivants pour déterminer la fonctionnalité à utiliser :

• Le texte fantôme est préférable lorsque vous souhaitez ajouter d’autres cas de test à un fichier de test existant qui affiche déjà le modèle.
• Correction d’un échec de test dans l’Explorateur de tests est préférable lorsqu’un test unique échoue et que vous souhaitez un correctif rapide et ciblé.
• /fixTestFailure dans la vue Chat est préférable lorsque vous souhaitez ajouter davantage de contexte ou gérer plusieurs échecs.
• Exécutions de tests pilotées parAgent sont optimales lorsque vous souhaitez GitHub Copilot exécuter des tests, diagnostiquer des échecs et appliquer des correctifs sur plusieurs fichiers d’une session.

Ensemble, ces outils terminent le flux de travail de test unitaire. La vue Chat, l’agent de planification et l’Agent génèrent les tests initiaux ; le texte fantôme complète la couverture ; et les fonctionnalités de correction des échecs de test maintiennent la suite au vert à mesure que votre code évolue.