WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

unittest.expectedFailure

Der Dekorator kennzeichnet einen erwarteten Fehlschlag der Testmethode.

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

Syntax

@unittest.expectedFailure

Der 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.

Quellen