Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje