L'Assert.Equals de NUnit lance l'exception "Assert.Equals ne doit pas être utilisé pour les assertions".

Question

J'ai récemment essayé d'utiliser la méthode Assert.Equals() lors de l'écriture d'un nouveau test NUnit. Lors de l'exécution de cette méthode, un AssertionException déclarant que Assert.Equals should not be used for Assertions. C'est un peu déconcertant à première vue. Que se passe-t-il ici ?

Answer 1

Assert est une classe statique héritant de System.Object, comme toutes les classes le font implicitement en C#. System.Object implémente la méthode suivante :

static bool Equals(object a, object b)

Les méthodes d'Assert destinées à la comparaison d'égalité sont les suivantes Assert.AreEqual() des méthodes. Par conséquent, l'appel à la méthode Object.Equals() à travers la classe Assert dans un test unitaire est certainement une erreur. Afin de prévenir cette erreur et d'éviter toute confusion, les développeurs de NUnit ont intentionnellement caché les éléments suivants Object.Equals dans la classe Assert avec une implémentation qui lève une exception. Voici cette implémentation :

/// <summary>
 /// The Equals method throws an AssertionException. This is done
 /// to make sure there is no mistake by calling this function.
 /// </summary>
 /// <param name="a"></param>
 /// <param name="b"></param>
 [EditorBrowsable(EditorBrowsableState.Never)]
 public static new bool Equals(object a, object b)
 {
     // TODO: This should probably be InvalidOperationException
     throw new AssertionException("Assert.Equals should not be used for Assertions");
 }

Bien sûr, le message d'exception lui-même est déroutant, mais il vous permet au moins de savoir ce que vous avez fait. quelque chose erronée.

Answer 2

Tldr ;

Assert.AreEqual(a, b); // <-- Compares a, b

pas :

Assert.Equals(a, b); // <-- Irrelevant equality operator on Assert itself