Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

TimeoutError / asyncio.TimeoutError — superamento di un limite di tempo

TimeoutError segnala che un’operazione ha superato il proprio limite di tempo. In Python 3.14, asyncio.TimeoutError è un alias deprecato della stessa classe, non un’eccezione distinta. Intercetta TimeoutError e distingui un timeout dal normale annullamento di un’attività.

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

Sintassi

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

Il TimeoutError integrato è una sottoclasse di OSError; per le funzioni di sistema corrisponde all’errore errno.ETIMEDOUT. Anche i meccanismi di timeout di asyncio lo usano. Un’operazione che dura a lungo non genera automaticamente questa eccezione: il limite deve essere previsto dall’API utilizzata o dalla sua configurazione.

Da Python 3.11, asyncio.TimeoutError è un alias deprecato del TimeoutError integrato. In Python 3.14, asyncio.TimeoutError is TimeoutError restituisce True. Nel nuovo codice usa except TimeoutError:; non servono due gestori per questi nomi.

asyncio.timeout(seconds) annulla l’attività corrente quando il limite scade e trasforma il conseguente asyncio.CancelledError in TimeoutError all’uscita dal contesto. Per questo motivo, inserisci l’except che lo gestisce all’esterno del blocco async with. Il normale annullamento di un’attività è un caso distinto; non ignorare asyncio.CancelledError all’interno dell’operazione.

Allo scadere del tempo, asyncio.wait_for() richiede l’annullamento dell’operazione attesa. Attende che l’annullamento sia completato, quindi il tempo totale di attesa può superare il limite specificato. Se l’operazione si interrompe per effetto di quell’annullamento, asyncio.wait_for() solleva TimeoutError. Se invece la coroutine attesa intercetta asyncio.CancelledError e restituisce un valore, asyncio.wait_for() restituisce quel valore. Un’eccezione sollevata durante l’annullamento può propagarsi. Intercetta l’eccezione il più vicino possibile all’operazione di cui puoi gestire l’errore.

Identificatori di riferimento trattati in questa voce: TimeoutError / asyncio.TimeoutError.

Esempi

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

Risultato

True
Timed out

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti