Procédure pas à pas : création et exécution de tests unitaires pour le code managé

Article
11/25/2015

Cette procédure pas à pas décrit la création, l'exécution et la personnalisation d'une série de tests unitaires à l'aide de l'infrastructure des test unitaires Microsoft pour le code managé et l'Explorateur de Tests de Visual Studio.Vous commencez avec un projet C# qui est en développement, vous créez des tests qui exercent son code, vous exécutez les tests et vous examinez les résultats.Ensuite, vous pouvez modifier votre code de projet et réexécuter les tests.

Cette rubrique contient les sections suivantes :

Prepare the walkthrough

Create a unit test project

Create the test class

Test class requirements

Create the first test method

Test method requirements

Build and run the test

Fix your code and rerun your tests

Use unit tests to improve your code

[!REMARQUE]

Cette procédure pas à pas utilise l'infrastructure des tests unitaires Microsoft pour le code managé.L'Explorateur de Tests peut également exécuter des tests sur des infrastructures de tests unitaires qui ont des adaptateurs pour l'Explorateur de Tests.Pour plus d'informations, consultez Comment : installer des infrastructures de tests unitaires tiers

[!REMARQUE]

Pour plus d'informations sur la façon d'exécuter des tests à partir d'une ligne de commande, consultez Procédure pas à pas : utilisation de l'utilitaire de test de ligne de commande.

Composants requis

Le projet Bank.Consultez Exemple de projet pour la création de tests unitaires.

Préparation de la procédure pas à pas

Ouvrez Visual Studio.
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.

La boîte de dialogue Nouveau projet s'affiche.
Sous Modèles installés, cliquez sur Visual C#.
Dans la liste de types d'applications, cliquez sur Bibliothèque de classes.
Dans la zone Nom, tapez Banque, puis cliquez sur OK.

[!REMARQUE]

Si le nom « Bank » est déjà utilisé, choisissez un autre nom pour le projet.

Le nouveau projet Banque est créé et affiché dans l'Explorateur de solutions, avec le fichier Class1.cs ouvert dans l'éditeur de code.

[!REMARQUE]

Si le fichier Class1.cs n'est pas ouvert dans l'éditeur de code, double-cliquez sur ce fichier dans l'Explorateur de solutions pour l'ouvrir.
Copiez le code source de l'Exemple de projet pour la création de tests unitaires.
Remplacez le contenu d'origine de Class1.cs par le code de l'Exemple de projet pour la création de tests unitaires.
Enregistrez le fichier avec le nom BankAccount.cs
Dans le menu Générer, cliquez sur Générer la solution.

Vous avez maintenant un projet nommé Bank.Il contient le code source à tester et des outils avec lesquels le tester.L'espace de noms pour Bank, BankAccountNS, contient la classe publique BankAccount, dont vous testerez les méthodes dans les procédures suivantes.

Dans ce démarrage rapide, nous nous concentrons sur la méthode Debit.La méthode Debit est appelée quand de l’argent est retiré d’un compte et contient le code suivant :

// method under test
public void Debit(double amount)
{
    if(amount > m_balance)
    {
        throw new ArgumentOutOfRangeException("amount");
    }
    if (amount < 0)
    {
        throw new ArgumentOutOfRangeException("amount");
    }
    m_balance += amount;
}

Créer un projet de test unitaire

Condition préalable : suivez les étapes de la procédure intitulée Prepare the walkthrough.

Pour créer un projet de test unitaire

Dans le menu Fichier, choisissez Ajouter, puis Nouveau projet....
Dans la boîte de dialogue Nouveau Projet, développez Installé, développez Visual C#, puis choisissez Test.
Dans la liste des modèles, sélectionnez Projet de Test Unitaire.
Dans la zone Nom, entrez BankTest, puis choisissez OK.

Le projet BankTests est ajouté à la solution Bank.
Dans le projet BankTests, ajoutez une référence à la solution Bank.

Dans l'Explorateur de Solutions, sélectionnez Références dans le projet BankTests puis choisissez Ajouter une Référence… dans le menu contextuel.
Dans la boîte de dialogue Gestionnaire de références, développez Solution puis cochez l'élément Bank.

Créer la classe de test

Nous avons besoin d'une classe de test pour vérifier la classe BankAccount.Nous pouvons utiliser UnitTest1.cs qui a été généré par le modèle de projet, mais nous devons donner au fichier et à la classe des noms plus descriptifs.Nous pouvons effectuer cela en une seule étape en renommant le fichier dans l'Explorateur de Solutions.

Changement de nom d'un fichier de classe

Dans l'Explorateur de Solutions, sélectionnez le fichier UnitTest1.cs dans le projet BankTests.Dans le menu contextuel, choisissez Renommer, puis renommez le fichier BankAccountTests.cs.Choisissez Oui dans la boîte de dialogue qui vous demande si vous souhaitez remplacer le nom de toutes les références du projet par « UnitTest1 ».Cette opération a pour effet de remplacer le nom de la classe par BankAccountTests.

Le fichier BankAccountTests.cs contient maintenant le code suivant :

// unit test code
using System;
using Microsoft.VisualStudio.TestTools.UnitTesting;

namespace BankTests
{
    [TestClass]
    public class BankAccountTests
    {
        [TestMethod]
        public void TestMethod1()
        {
        }
    }
}

Ajouter une instruction using au projet testé

Nous pouvons également ajouter une instruction using à la classe pour nous permettre d'appeler dans le projet testé sans utiliser de noms complets qualifiés.En haut du fichier de classe, ajoutez :

using BankAccountNS;

Spécifications de la classe de test

La configuration minimale requise pour une classe de test est la suivante :

L'attribut [TestClass] est requis dans l'infrastructure de test unitaire Microsoft pour le code managé pour toute classe qui contient les méthodes de test unitaire à exécuter dans l'Explorateur de Tests.
Chaque méthode de test à exécuter avec l'Explorateur de Tests doit avoir l'attribut [TestMethod].

Vous pouvez avoir d'autres classes dans un projet de test unitaire qui n'ont pas l'attribut [TestClass], et vous pouvez avoir d'autres méthodes dans les classes de test qui n'ont pas l'attribut [TestMethod].Vous pouvez utiliser ces autres classes et méthodes dans vos méthodes de test.

Créer la première méthode de test

Dans cette procédure, nous écrirons des méthodes de test unitaire pour vérifier le comportement de la méthode Debit de la classe BankAccount.La méthode est répertoriée ci-dessus.

En analysant la méthode testée, nous déterminons qu'il existe au moins trois comportements qui doivent être vérifiés :

La méthode lève une exception [ArgumentOutOfRangeException] si le montant du débit est supérieur au solde.
Elle lève également l’exception ArgumentOutOfRangeException si le montant du débit est inférieur à zéro.
Si les contrôles en 1.) et 2.) sont satisfaisants, la méthode soustrait le montant du solde du compte.

Dans notre premier test, l’utilisation d’un montant valide (inférieur au solde du compte et supérieur à zéro) retire le montant approprié du compte.

Pour créer une méthode de test

Ajoutez une instruction using BankAccountNS; au fichier BankAccountTests.cs.

Ajoutez la méthode suivante à cette classe BankAccountTests :

// unit test code
[TestMethod]
public void Debit_WithValidAmount_UpdatesBalance()
{
    // arrange
    double beginningBalance = 11.99;
    double debitAmount = 4.55;
    double expected = 7.44;
    BankAccount account = new BankAccount("Mr. Bryan Walton", beginningBalance);

    // act
    account.Debit(debitAmount);

    // assert
    double actual = account.Balance;
    Assert.AreEqual(expected, actual, 0.001, "Account not debited correctly");
}

La méthode est plutôt simple.Nous mettons en place un nouvel objet BankAccount avec un solde de début puis nous retirons un montant valide.Nous utilisons la méthode de l'infrastructure des tests unitaires Microsoft pour le code managé AreEqual pour vérifier que le solde de fin correspond à ce que nous attendions.

Spécifications des méthodes de test

Une méthode de test doit répondre aux spécifications suivantes :

La méthode doit être décorée avec l'attribut [TestMethod].
La méthode doit retourner void.
La méthode ne peut pas avoir de paramètres.

Générer et exécuter le test

Pour générer et exécuter le test

Dans le menu Générer, choisissez Générer la solution.

S'il n'y a pas d'erreurs, la fenêtre UnitTestExplorer apparaît avec Debit_WithValidAmount_UpdatesBalance répertorié dans le groupe Tests non exécutés.Si l'Explorateur de Tests n'apparaît pas après une génération réussie, sélectionnez Test dans le menu, puis Windows, puis Explorateur de Tests.
Sélectionnez Exécuter Tout pour exécuter le test.Pendant que le test s'exécute, la barre d'état en haut de la fenêtre s'anime.À l'issue de la série de tests, la barre devient verte si toutes les méthodes de test ont réussi, ou rouge si l'un des tests a échoué.
Dans ce cas, le test échoue.La méthode de test est déplacée vers le groupe Échecs de tests.Sélectionnez la méthode dans l'Explorateur de Tests pour en afficher les détails en bas de la fenêtre.

Vérifier votre code et exécuter à nouveau vos tests

Analyser les résultats des tests

Le résultat de test contient un message qui décrit l'échec.Pour la méthode AreEquals, un message vous affiche ce qui était attendu (le paramètre Expected<XXX>) et ce qui a été reçu réellement (le paramètre Actual<YYY>).Nous nous attendions à ce que le solde décline par rapport au solde de début, mais il a plutôt augmenté du montant du retrait.

Un réexamen du code Debit indique que le test unitaire a réussi à trouver un bogue.Le montant du retrait est ajouté au solde du compte lorsqu'il doit être soustrait.

Corriger le bogue

Pour corriger l'erreur, remplacez simplement la ligne

m_balance += amount;

with

m_balance -= amount;

Réexécuter le test

Dans l'Explorateur de tests, choisissez Exécuter Tout pour réexécuter le test.La barre rouge/verte devient verte, et le test est déplacé dans le groupe Tests Réussis.

Utiliser les tests unitaires pour améliorer votre code

Cette section décrit comment un processus itératif d'analyse, de développement de test unitaire et de refactorisation peut vous aider à rendre votre code de production plus fiable et efficace.

Analyser les problèmes

Après avoir créé une méthode de test pour vérifier qu'un montant valide est correctement déduit dans la méthode Debit, nous pouvons nous tourner vers les cas restants dans notre analyse d'origine :

La méthode lève une exception ArgumentOutOfRangeException si le montant du débit est supérieur au solde.
Elle lève également l’exception ArgumentOutOfRangeException si le montant du débit est inférieur à zéro.

Créer les méthodes de test

Une première tentative de création d'une méthode de test pour résoudre ces problèmes semble prometteuse :

//unit test method
[TestMethod]
[ExpectedException(typeof(ArgumentOutOfRangeException))]
public void Debit_WhenAmountIsLessThanZero_ShouldThrowArgumentOutOfRange()
{
    // arrange
    double beginningBalance = 11.99;
    double debitAmount = -100.00;
    BankAccount account = new BankAccount("Mr. Bryan Walton", beginningBalance);

    // act
    account.Debit(debitAmount);

    // assert is handled by ExpectedException
}

Nous utilisons l'attribut ExpectedExceptionAttribute pour déclarer que la bonne exception a été levée.L'attribut entraîne l'échec du test à moins qu'une exception ArgumentOutOfRangeException ne soit levée.L'exécution du test avec à la fois les valeurs debitAmount positives et négatives puis en modifiant temporairement la méthode testée pour lever une exception ApplicationException générique lorsque le montant st inférieur à zéro indique que le test se comporte correctement.Pour tester le cas lorsque le montant retiré est supérieur au solde, il suffit d'effectuer les opérations suivantes :

Créez une méthode de test nommée Debit_WhenAmountIsMoreThanBalance_ShouldThrowArgumentOutOfRange.
Copiez le corps de la méthode depuis Debit_WhenAmountIsLessThanZero_ShouldThrowArgumentOutOfRange vers la nouvelle méthode.
Définissez debitAmount sur un nombre supérieur au solde.

Exécuter les tests

L'exécution des deux méthodes avec des valeurs différentes pour debitAmount montre que les tests gèrent correctement nos cas restants.L'exécution des trois tests confirme que tous les cas présents dans notre analyse d'origine sont traités correctement.

Poursuivez l'analyse

Toutefois, les deux dernières méthodes de test sont également quelque peu troublantes.Nous ne pouvons pas être certains de la condition du code qui lève une exception lorsque l'un ou l'autre des tests est exécuté.Un moyen de faire la différence entre les deux conditions serait utile.Lorsque nous réfléchissons au problème, il devient clair que connaître la condition qui n'a pas été respectée augmenterait notre confiance dans les tests.Ces informations seraient également très probablement utiles pour le mécanisme de production qui gère l'exception lorsqu'elle est levée par la méthode testée.Générer plus d'informations lorsque la méthode lève une exception aiderait tous les éléments concernés, mais l'attribut ExpectedException ne peut pas fournir ces informations.

En examinant encore la méthode testée, nous constatons que les deux instructions conditionnelles utilisent un constructeur ArgumentOutOfRangeException qui accepte le nom de l'argument comme paramètre :

throw new ArgumentOutOfRangeException("amount");

En effectuant des recherches dans MSDN Library, nous découvrons qu'il existe un constructeur qui génère des informations bien plus élaborées.#ctor(String, Object, String) inclut le nom de l'argument, la valeur de l'argument et un message défini par l'utilisateur.Nous pouvons refactoriser la méthode testée pour utiliser ce constructeur.Il y a encore mieux : nous pouvons utiliser les membres de type disponibles publiquement pour spécifier les erreurs.

Refactoriser le code testé

Nous définissons d'abord deux constantes pour les messages d'erreur au niveau de la portée d'une classe :

// class under test
public const string DebitAmountExceedsBalanceMessage = "Debit amount exceeds balance";
public const string DebitAmountLessThanZeroMessage = "Debit amount less than zero";

Nous modifions ensuite les deux instructions conditionnelles dans la méthode Debit :

// method under test
// ...
    if (amount > m_balance)
    {
        throw new ArgumentOutOfRangeException("amount", amount, DebitAmountExceedsBalanceMessage);
    }

    if (amount < 0)
    {
        throw new ArgumentOutOfRangeException("amount", amount, DebitAmountLessThanZeroMessage);
    }
// ...

Refactoriser les méthodes de test

Dans notre méthode de test, nous commençons par supprimer l'attribut ExpectedException.À sa place, nous interceptons l'exception levée et vérifions qu'elle a été levée dans l'instruction de condition appropriée.Toutefois, nous devons maintenant choisir entre deux options pour vérifier nos conditions restantes.Par exemple, dans la méthode Debit_WhenAmountIsMoreThanBalance_ShouldThrowArgumentOutOfRange, nous pouvons effectuer l'une des actions suivantes :

Déclarer que la propriété ActualValue de l'exception (le deuxième paramètre du constructeur de ArgumentOutOfRangeException) est supérieure au solde de début.Cette option nécessite de tester la propriété ActualValue de l'exception par rapport à la variable beginningBalance de la méthode de test, mais aussi de vérifier que ActualValue est supérieur à zéro.
Déclarez que le message (le troisième paramètre du constructeur) inclut le DebitAmountExceedsBalanceMessage défini dans la classe BankAccount.

La méthode StringAssert.Contains dans l'infrastructure de tests unitaires Microsoft nous permet de vérifier la deuxième option sans les calculs requis par la première option.

Une deuxième tentative de révision de Debit_WhenAmountIsMoreThanBalance_ShouldThrowArgumentOutOfRange pourrait ressembler à :

[TestMethod]
public void Debit_WhenAmountIsMoreThanBalance_ShouldThrowArgumentOutOfRange()
{
    // arrange
    double beginningBalance = 11.99;
    double debitAmount = 20.0;
    BankAccount account = new BankAccount("Mr. Bryan Walton", beginningBalance);

    // act
    try
    {
        account.Debit(debitAmount);
    }
    catch (ArgumentOutOfRangeException e)
    {
        // assert
        StringAssert.Contains(e.Message, BankAccount. DebitAmountExceedsBalanceMessage);
    }
}

Retester, réécrire et réanalyser

Lorsque nous retestons les méthodes de test avec des valeurs différentes, nous obtenons les informations suivantes :

Si nous interceptons l’erreur correcte à l’aide d’une assertion où debitAmount est supérieur au solde, l’assertion Contains passe, l’exception est ignorée et la méthode de test passe alors.Il s'agit du comportement que nous souhaitons.
Si nous utilisons un debitAmount inférieur à 0, l’assertion échoue, car un mauvais message d’erreur est retourné.L'assertion échoue également si nous introduisons une exception ArgumentOutOfRange temporaire à un autre point dans le chemin de code de la méthode testée.Cela aussi est approprié.
Si la valeur de debitAmount est valide (c.-à-d. inférieure au solde mais supérieure à zéro), aucune exception n'est interceptée, donc l'assertion n'est jamais interceptée.La méthode de test réussit.Cela ne convient pas, car nous souhaitons que la méthode de test échoue si aucune exception n'est levée.

Le troisième fait est un bogue dans notre méthode de test.Pour essayer de résoudre le problème, nous ajoutons une assertion Fail à la fin de la méthode de test pour gérer le cas où aucune exception n'est levée.

Mais un nouveau test montre que le test échoue maintenant si l'exception correcte est interceptée.L'instruction catch réinitialise l'exception et la méthode continue à s'exécuter. Elle échoue sur la nouvelle assertion.Pour résoudre le nouveau problème, nous ajoutons une instruction return après StringAssert.Le nouveau test confirme que nous avons résolu nos problèmes.Notre version finale de Debit_WhenAmountIsMoreThanBalance_ShouldThrowArgumentOutOfRange ressemble à ce qui suit :

[TestMethod]
public void Debit_WhenAmountIsMoreThanBalance_ShouldThrowArgumentOutOfRange()
{
    // arrange
    double beginningBalance = 11.99;
    double debitAmount = 20.0;
    BankAccount account = new BankAccount("Mr. Bryan Walton", beginningBalance);

    // act
    try
    {
        account.Debit(debitAmount);    
    }
    catch (ArgumentOutOfRangeException e)
    {
        // assert
        StringAssert.Contains(e.Message, BankAccount. DebitAmountExceedsBalanceMessage);
        return;
    }
    Assert.Fail("No exception was thrown.");
}

Dans cette section finale, le travail que nous avons fait en améliorant notre code de test a conduit à des méthodes de test plus fiables et plus instructives.Mais plus important encore, l'analyse supplémentaire a également conduit à du meilleur code dans notre projet testé.