CKTIS / Python
unittest.TestResult.errors — erreurs de test enregistrées
`unittest.TestResult.errors` associe l’objet correspondant à chaque erreur à une trace de pile mise en forme. Avec la valeur par défaut de `failureException` (`AssertionError`), les échecs d’assertion dans les méthodes de test non marquées par `expectedFailure` sont enregistrés séparément dans `failures`.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
result.errors # result is an instance of unittest.TestResult
for test, traceback_text in result.errors:
...unittest.TestResult.errors est un attribut d’instance, et non une méthode. Il contient une liste de tuples (test, traceback_text). Le premier élément est l’objet associé à l’erreur ; le second est une chaîne contenant la trace de pile mise en forme, et non un objet d’exception. Par exemple, si setUpClass lève une exception, unittest peut utiliser un objet interne de substitution à la place d’une instance de TestCase.
Pour une méthode de test non marquée par expectedFailure, unittest distingue les échecs des erreurs d’après le type failureException du cas de test. Si l’exception à enregistrer est une instance de ce type ou d’une sous-classe, elle est enregistrée dans failures ; sinon, elle est enregistrée dans errors. Par défaut, failureException vaut AssertionError : une exception ValueError est donc enregistrée dans errors, tandis qu’un échec d’assertion tel que celui de self.assertEqual(1, 2) est enregistré dans failures. Si failureException vaut ValueError, une exception ValueError est enregistrée dans failures plutôt que dans errors. En revanche, une exception AssertionError levée par setUpClass est enregistrée dans errors. Un échec d’assertion dans une méthode de test marquée par expectedFailure est enregistré dans expectedFailures. L’implémentation par défaut de addError() ajoute une entrée à errors ; normalement, unittest enregistre automatiquement le résultat.
L’exemple montre ces deux résultats avec la valeur par défaut de failureException pour des méthodes de test non marquées par expectedFailure et vérifie le texte enregistré sans afficher les chemins et numéros de ligne variables. Une liste errors vide ne prouve pas que tout a réussi : vérifiez result.wasSuccessful() pour tenir compte également des autres résultats qui empêchent de considérer l’exécution comme réussie.
Exemples
import unittest
class Demo(unittest.TestCase):
def test_error(self):
raise ValueError("demo")
def test_failure(self):
self.assertEqual(1, 2)
suite = unittest.TestSuite([
Demo("test_error"),
Demo("test_failure"),
])
result = unittest.TestResult()
suite.run(result)
print("errors:", len(result.errors))
print("failures:", len(result.failures))
test, traceback_text = result.errors[0]
print("test:", test.id().rsplit(".", 1)[-1])
print("message present:", "ValueError: demo" in traceback_text)
print("successful:", result.wasSuccessful())Résultat
errors: 1 failures: 1 test: test_error message present: True successful: False
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.