CKTIS / Python
TimeoutError / asyncio.TimeoutError — prekročenie časového limitu
TimeoutError signalizuje, že operácia prekročila svoj časový limit. V Pythone 3.14 je asyncio.TimeoutError zastaraný alias tej istej triedy, nie samostatná výnimka. Zachytávajte TimeoutError a rozlišujte prekročenie limitu od bežného zrušenia úlohy.
Verzia: Python 3.14; repository image, production runtime not attested
Syntax
try:
async with asyncio.timeout(seconds):
await operation()
except TimeoutError:
...Vstavaný TimeoutError je podtriedou OSError; pri systémových funkciách zodpovedá chybe errno.ETIMEDOUT. Používajú ho aj mechanizmy časového limitu v asyncio. Dlhé trvanie operácie túto výnimku automaticky nevyvolá: limit musí vychádzať z použitého API alebo jeho konfigurácie.
Od Pythonu 3.11 je asyncio.TimeoutError zastaraným aliasom vstavaného TimeoutError. V Pythone 3.14 sa výraz asyncio.TimeoutError is TimeoutError vyhodnotí ako True. V novom kóde používajte except TimeoutError:; pre tieto názvy nepotrebujete dva obslužné bloky.
asyncio.timeout(seconds) po uplynutí limitu zruší aktuálnu úlohu a pri opustení kontextu prevedie vzniknutý asyncio.CancelledError na TimeoutError. Preto umiestnite obslužný except mimo bloku async with. Bežné zrušenie úlohy je samostatný prípad; vnútri operácie nepotláčajte asyncio.CancelledError.
Po uplynutí časového limitu požiada asyncio.wait_for() o zrušenie operácie, na ktorú čaká. Čaká na dokončenie rušenia, takže celkový čas čakania môže prekročiť zadaný limit. Ak sa operácia v dôsledku zrušenia skončí, asyncio.wait_for() vyvolá TimeoutError. Ak však korutina, na ktorú sa čaká, zachytí asyncio.CancelledError a vráti hodnotu, asyncio.wait_for() túto hodnotu vráti. Výnimka vyvolaná počas rušenia sa môže šíriť ďalej. Výnimku zachytávajte čo najbližšie k operácii, ktorej zlyhanie dokážete obslúžiť.
Referenčné identifikátory zahrnuté v tomto hesle: TimeoutError / asyncio.TimeoutError.
Prí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ýsledok
True Timed out
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.