Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje