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

CKTIS / Python

unittest.expectedFailure

Le décorateur signale un échec attendu dans la méthode de test.

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

Syntaxe

@unittest.expectedFailure

Le décorateur signale un échec attendu dans la méthode de test.

L’exception SkipTest est traitée séparément et entre dans skipped au lieu de expectedFailures. Une assertion échouée ou une autre exception ordinaire dans son corps entre dans expectedFailures, soit 1 échec attendu et 0 échec ordinaire ici. Un test devenu réussi entre dans unexpectedSuccesses et wasSuccessful() vaut False.

Une erreur dans setUp ou tearDown reste une erreur.

import unittest
class Known(unittest.TestCase):
    @unittest.expectedFailure
    def test_broken(self): raise ValueError('broken')
    @unittest.expectedFailure
    def test_fixed(self): pass
class Setup(Known):
    def setUp(self): raise ValueError('fixture')
r=unittest.TestResult()
Known('test_broken').run(r)
assert len(r.expectedFailures)==1 and r.wasSuccessful()
Known('test_fixed').run(r)
assert len(r.unexpectedSuccesses)==1 and not r.wasSuccessful()
Setup('test_broken').run(r)
assert len(r.errors)==1
class Omit(unittest.TestCase):
    @unittest.expectedFailure
    def test_skip(self): raise unittest.SkipTest('reason')
r=unittest.TestResult()
Omit('test_skip').run(r)
assert len(r.skipped)==1 and not r.expectedFailures

Exemples

import unittest
class Check(unittest.TestCase):
    @unittest.expectedFailure
    def test_known(self): self.assertEqual(2, 3)

r = unittest.TestResult()
Check("test_known").run(r)
print(len(r.expectedFailures), len(r.failures))

Résultat

1 0

Une erreur dans setUp ou tearDown reste une erreur.

Sources