CKTIS / Python
unittest.expectedFailure
O decorador assinala uma falha esperada no método de teste.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
@unittest.expectedFailureO decorador assinala uma falha esperada no método de teste.
A exceção SkipTest tem tratamento próprio e entra em skipped em vez de expectedFailures. Uma asserção falhada ou outra exceção comum no corpo entra em expectedFailures, com 1 falha esperada e 0 comuns no exemplo. Um teste que passa entra em unexpectedSuccesses e wasSuccessful() devolve False.
Um erro em setUp ou tearDown continua a ser um erro.
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
Exemplos
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))
Resultado
1 0
Um erro em setUp ou tearDown continua a ser um erro.