Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

AssertionError — assertion échouée

AssertionError est une exception intégrée déclenchée lorsque la condition d’une instruction assert est fausse. Les assertions vérifient les hypothèses internes du programme, et non la validation obligatoire des entrées : l’optimisation peut les supprimer.

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

Syntaxe

assert condition
assert condition, message
raise AssertionError(message)

AssertionError est une classe d’exception intégrée qui hérite de Exception. Lorsque les assertions sont activées, assert condition vérifie la valeur de vérité de la condition et déclenche AssertionError si elle est fausse. La forme assert condition, message transmet la valeur de message au constructeur de l’exception ; l’expression du message n’est évaluée que si la condition n’est pas satisfaite.

Une assertion exprime une hypothèse du programmeur sur l’état interne du programme. Dans l’exemple, first_item suppose que la liste n’est pas vide. L’appel avec [] enfreint cette hypothèse, et except AssertionError as exc intercepte l’exception et affiche son type et son message. L’interception sert ici à illustrer l’exception, pas à en corriger la cause.

N’utilisez pas assert pour la validation obligatoire des entrées utilisateur ni pour les contrôles d’autorisation. Avec l’optimisation, par exemple avec -O, les instructions assert sont ignorées : ni la condition ni le message ne sont évalués. N’y placez pas d’opérations indispensables au fonctionnement du programme. Écrivez les vérifications obligatoires avec if et un raise explicite, en choisissant une exception appropriée, comme ValueError pour une valeur d’argument inadaptée.

Vous pouvez aussi exécuter explicitement raise AssertionError(message) ; cette instruction n’est pas supprimée par l’optimisation. Pour diagnostiquer l’erreur, examinez l’hypothèse enfreinte et le code qui a produit l’état inattendu, au lieu de simplement supprimer l’assertion.

Exemples

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))

Résultat

AssertionError
items must not be empty

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources