Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

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

Fontes