Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

AssertionError — aserción fallida

AssertionError es una excepción integrada que se produce cuando la condición de una instrucción assert es falsa. Las aserciones comprueban supuestos internos del programa, no sirven para la validación obligatoria de entradas: la optimización puede eliminarlas.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

assert condition
assert condition, message
raise AssertionError(message)

AssertionError es una clase de excepción integrada que deriva de Exception. Cuando las aserciones están habilitadas, assert condition comprueba el valor de verdad de la condición y produce AssertionError si es falsa. La forma assert condition, message pasa el valor de message al constructor de la excepción; la expresión del mensaje solo se evalúa si la condición no se cumple.

Una aserción expresa un supuesto del programador sobre el estado interno del programa. En el ejemplo, first_item supone que la lista no está vacía. La llamada con [] incumple ese supuesto, y except AssertionError as exc captura la excepción e imprime su tipo y su mensaje. Aquí se captura para mostrar la excepción, no para corregir su causa.

No uses assert para la validación obligatoria de datos del usuario ni para comprobar permisos. Con la optimización, por ejemplo mediante -O, se omiten las instrucciones assert: no se evalúan ni la condición ni el mensaje. No incluyas en ellas operaciones necesarias para que el programa funcione. Escribe las comprobaciones obligatorias con if y un raise explícito, eligiendo una excepción adecuada, como ValueError para un valor de argumento inadecuado.

También puedes ejecutar explícitamente raise AssertionError(message); esa instrucción no se elimina con la optimización. Para diagnosticar el error, examina el supuesto incumplido y el código que produjo el estado inesperado, en lugar de limitarte a borrar la aserción.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes