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

CKTIS / Python

TimeoutError / asyncio.TimeoutError — dépassement d’un délai

TimeoutError signale qu’une opération a dépassé son délai. Dans Python 3.14, asyncio.TimeoutError est un alias obsolète de la même classe, et non une exception distincte. Interceptez TimeoutError et distinguez un dépassement de délai d’une annulation ordinaire de tâche.

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

Syntaxe

try:
    async with asyncio.timeout(seconds):
        await operation()
except TimeoutError:
    ...

Le TimeoutError intégré est une sous-classe de OSError ; pour les fonctions système, il correspond à l’erreur errno.ETIMEDOUT. Les mécanismes de délai de asyncio l’utilisent également. Une opération qui dure longtemps ne déclenche pas automatiquement cette exception : la limite doit être définie par l’API utilisée ou sa configuration.

Depuis Python 3.11, asyncio.TimeoutError est un alias obsolète du TimeoutError intégré. Dans Python 3.14, asyncio.TimeoutError is TimeoutError s’évalue à True. Dans le nouveau code, utilisez except TimeoutError: ; vous n’avez pas besoin de deux gestionnaires pour ces noms.

asyncio.timeout(seconds) annule la tâche en cours lorsque le délai expire et transforme le asyncio.CancelledError qui en résulte en TimeoutError à la sortie du contexte. Pour cette raison, placez le except qui le gère à l’extérieur du bloc async with. L’annulation ordinaire d’une tâche est un cas distinct ; ne masquez pas asyncio.CancelledError à l’intérieur de l’opération.

Lorsque le délai expire, asyncio.wait_for() demande l’annulation de l’opération attendue. La fonction attend la fin de l’annulation, si bien que la durée totale d’attente peut dépasser la limite spécifiée. Si l’opération est arrêtée par cette annulation, asyncio.wait_for() lève TimeoutError. En revanche, si la coroutine attendue intercepte asyncio.CancelledError et renvoie une valeur, asyncio.wait_for() renvoie cette valeur. Une exception levée pendant l’annulation peut se propager. Interceptez l’exception aussi près que possible de l’opération dont vous pouvez gérer l’échec.

Identifiants de référence couverts par cette entrée : TimeoutError / asyncio.TimeoutError.

Exemples

import asyncio

async def main():
    print(asyncio.TimeoutError is TimeoutError)
    event = asyncio.Event()
    try:
        async with asyncio.timeout(0):
            await event.wait()
    except TimeoutError:
        print("Timed out")

asyncio.run(main())

Résultat

True
Timed out

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