CKTIS / Python
TimeoutError / asyncio.TimeoutError — překročení časového limitu
TimeoutError signalizuje, že operace překročila svůj časový limit. V Pythonu 3.14 je asyncio.TimeoutError zastaralý alias téže třídy, nikoli samostatná výjimka. Zachytávejte TimeoutError a rozlišujte překročení limitu od běžného zrušení úlohy.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
try:
async with asyncio.timeout(seconds):
await operation()
except TimeoutError:
...Vestavěný TimeoutError je podtřídou OSError; u systémových funkcí odpovídá chybě errno.ETIMEDOUT. Používají ho také mechanismy časového limitu v asyncio. Dlouhé trvání operace tuto výjimku automaticky nevyvolá: limit musí vycházet z použitého API nebo jeho konfigurace.
Od Pythonu 3.11 je asyncio.TimeoutError zastaralým aliasem vestavěného TimeoutError. V Pythonu 3.14 se výraz asyncio.TimeoutError is TimeoutError vyhodnotí jako True. V novém kódu používejte except TimeoutError:; pro tyto názvy nepotřebujete dva obslužné bloky.
asyncio.timeout(seconds) po vypršení limitu zruší aktuální úlohu a při opuštění kontextu převede vzniklý asyncio.CancelledError na TimeoutError. Proto umístěte obslužný except mimo blok async with. Běžné zrušení úlohy je jiný případ; uvnitř operace nepotlačujte asyncio.CancelledError.
Po vypršení časového limitu požádá asyncio.wait_for() o zrušení operace, na kterou čeká. Čeká na dokončení rušení, takže celková doba čekání může překročit zadaný limit. Pokud operace v důsledku zrušení skončí, asyncio.wait_for() vyvolá TimeoutError. Pokud ale korutina, na kterou se čeká, zachytí asyncio.CancelledError a vrátí hodnotu, asyncio.wait_for() tuto hodnotu vrátí. Výjimka vyvolaná během rušení se může šířit dál. Výjimku zachytávejte co nejblíže operaci, jejíž selhání dokážete obsloužit.
Referenční identifikátory zahrnuté v tomto hesle: TimeoutError / asyncio.TimeoutError.
Příklady
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())Výsledek
True Timed out
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.