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.