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

CKTIS / Python

AssertionError — asserção falhada

AssertionError é uma exceção integrada lançada quando a condição de uma instrução assert é falsa. As asserções verificam pressupostos internos do programa, não se destinam à validação obrigatória de entradas: a otimização pode removê-las.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

assert condition
assert condition, message
raise AssertionError(message)

AssertionError é uma classe de exceção integrada que deriva de Exception. Quando as asserções estão ativadas, assert condition verifica o valor lógico da condição e lança AssertionError se esta for falsa. A forma assert condition, message passa o valor de message ao construtor da exceção; a expressão da mensagem só é avaliada quando a condição não é satisfeita.

Uma asserção exprime um pressuposto do programador sobre o estado interno do programa. No exemplo, first_item pressupõe que a lista não está vazia. A chamada com [] viola esse pressuposto, e except AssertionError as exc captura a exceção e apresenta o respetivo tipo e mensagem. Neste caso, a captura serve para demonstrar a exceção, não para corrigir a sua causa.

Não uses assert para a validação obrigatória de dados do utilizador nem para verificações de permissões. Com a otimização, por exemplo através de -O, as instruções assert são ignoradas: nem a condição nem a mensagem são avaliadas. Não coloques nelas operações necessárias para o funcionamento do programa. Escreve as verificações obrigatórias com if e um raise explícito, escolhendo uma exceção adequada, como ValueError para um valor de argumento inadequado.

Também podes executar explicitamente raise AssertionError(message); essa instrução não é removida pela otimização. Ao diagnosticar o erro, verifica o pressuposto violado e o código que produziu o estado inesperado, em vez de simplesmente eliminares a asserção.

Exemplos

def first_item(items):
    assert len(items) > 0, "items must not be empty"
    return items[0]

try:
    first_item([])
except AssertionError as exc:
    print(type(exc).__name__)
    print(str(exc))

Resultado

AssertionError
items must not be empty

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes