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

CKTIS / Python

KeyError — clé manquante dans un mapping

KeyError signifie qu’une clé demandée est introuvable dans un mapping, comme un dict. Découvrez la différence entre l’accès avec des crochets et get(), et gérez les clés manquantes sans masquer les erreurs sans rapport.

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

Syntaxe

try:
    value = mapping[key]
except KeyError:
    ...

KeyError est une exception intégrée qui hérite de LookupError. Elle signale qu’une clé demandée est absente d’un mapping. Pour un dict ordinaire, mapping[key] déclenche cette exception si la clé n’existe pas. Ne la confondez pas avec IndexError, qui concerne un indice de séquence hors limites.

Si l’absence d’une clé est prévisible, utilisez try / except KeyError ou mapping.get(key, default). Pour un dict, get() ne renvoie la valeur par défaut que si la clé est absente ; sans valeur par défaut explicitement indiquée, il renvoie alors None. Une clé existante dont la valeur est None n’est pas une clé manquante et ne déclenche pas l’utilisation de la valeur par défaut. L’expression key in mapping vérifie si la clé est présente.

Limitez le bloc try à l’opération dont vous souhaitez gérer l’absence de clé, afin de ne pas intercepter accidentellement un KeyError provenant d’un autre appel. Si la clé est obligatoire, corrigez les données d’entrée ou laissez l’exception se propager au lieu de l’ignorer systématiquement.

L’exemple oppose la clé "language" manquante à la clé "nickname" existante, dont la valeur est None. À noter : une sous-classe de dict peut définir __missing__() et modifier le comportement de mapping[key] lorsqu’une clé est absente ; get() ne fait pas appel à ce mécanisme.

Exemples

settings = {"theme": "dark", "nickname": None}

try:
    print(settings["language"])
except KeyError:
    print("Missing key: language")

print(settings.get("language", "en"))
print(settings.get("nickname", "guest"))

Résultat

Missing key: language
en
None

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