CKTIS / Python
unittest.expectedFailure
Der Dekorator kennzeichnet einen erwarteten Fehlschlag der Testmethode.
Version: Python 3.14; repository image, production runtime not attested
Syntax
@unittest.expectedFailureDer Dekorator kennzeichnet einen erwarteten Fehlschlag der Testmethode.
Eine Ausnahme vom Typ SkipTest wird getrennt behandelt und landet in skipped statt in expectedFailures. Eine fehlgeschlagene Assertion oder eine andere gewöhnliche Ausnahme im Methodenrumpf landet in expectedFailures, im Beispiel also 1 erwarteter und 0 gewöhnliche Fehlschläge. Ein plötzlich erfolgreicher Test landet in unexpectedSuccesses und wasSuccessful() ergibt False.
Ein Fehler in setUp oder tearDown bleibt ein Fehler.
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
Beispiele
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))
Ergebnis
1 0
Ein Fehler in setUp oder tearDown bleibt ein Fehler.