Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

unittest.TestResult.failures — liste des échecs d’assertion

unittest.TestResult.failures stocke les échecs d’assertion sous forme de paires contenant un objet de test et le texte formaté de la trace d’exécution.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

result.failures
for test, traceback_text in result.failures:
    ...

unittest.TestResult.failures est un attribut d’instance, pas une méthode. Il contient une liste de paires (test, traceback_text) : un objet TestCase et une chaîne de caractères représentant une trace d’exécution formatée. Consultez cet attribut sur l’objet résultat après l’exécution des tests.

Pour classer une exception levée dans une méthode de test ordinaire comme échec ou comme erreur, unittest se fonde sur le type failureException du cas de test. Les exceptions de ce type ou de ses sous-classes sont ajoutées à failures, les autres à errors. Le type par défaut est AssertionError, levé par exemple lorsqu’un appel à assertEqual() échoue. En revanche, une exception AssertionError levée dans setUpClass est ajoutée à errors. Les échecs attendus sont stockés séparément dans expectedFailures. Une liste failures vide ne prouve donc pas que toute la suite de tests a réussi.

L’exemple provoque délibérément un échec. Il vérifie la structure de l’entrée sans afficher la trace d’exécution, dont les chemins et les numéros de ligne dépendent du fichier.

Exemples

import unittest


class SampleTest(unittest.TestCase):
    def test_total(self):
        self.assertEqual(2 + 2, 5)


result = unittest.TestResult()
SampleTest("test_total").run(result)

test, traceback_text = result.failures[0]
print("test:" if False else "failures:", len(result.failures))
print("test:", test.id())
print("traceback is text:", isinstance(traceback_text, str))
print("errors:", len(result.errors))

Résultat

failures: 1
test: __main__.SampleTest.test_total
traceback is text: True
errors: 0

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.

Sources