Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

TimeoutError / asyncio.TimeoutError — przekroczenie limitu czasu

TimeoutError sygnalizuje przekroczenie limitu czasu operacji. W Python 3.14 asyncio.TimeoutError jest przestarzałym aliasem tej samej klasy, a nie osobnym wyjątkiem. Przechwytuj TimeoutError i odróżniaj przekroczenie limitu od zwykłego anulowania zadania.

Wersja: Python 3.14; repository image, production runtime not attested

Składnia

try:
    async with asyncio.timeout(seconds):
        await operation()
except TimeoutError:
    ...

Wbudowany TimeoutError jest podklasą OSError; dla funkcji systemowych odpowiada błędowi errno.ETIMEDOUT. Używają go również mechanizmy limitów czasu w asyncio. Samo wykonanie operacji trwającej długo nie powoduje automatycznie tego wyjątku: limit musi wynikać z używanego API lub konfiguracji.

Od Python 3.11 asyncio.TimeoutError jest przestarzałym aliasem wbudowanego TimeoutError. W Python 3.14 wyrażenie asyncio.TimeoutError is TimeoutError daje True. W nowym kodzie używaj except TimeoutError:; nie potrzebujesz dwóch klauzul dla tych nazw.

asyncio.timeout(seconds) anuluje bieżące zadanie po przekroczeniu limitu i przekształca wynikający z tego asyncio.CancelledError w TimeoutError przy wyjściu z kontekstu. Dlatego umieść obsługujący go except poza blokiem async with. Zwykłe anulowanie zadania to odrębny przypadek; nie tłum wewnątrz operacji asyncio.CancelledError.

Po upływie limitu asyncio.wait_for() żąda anulowania operacji, na którą czeka. Czeka na zakończenie anulowania, więc łączny czas oczekiwania może przekroczyć podany limit. Jeśli operacja zakończy się wskutek tego anulowania, asyncio.wait_for() zgłosi TimeoutError. Jeśli jednak oczekiwana korutyna przechwyci asyncio.CancelledError i zwróci wartość, asyncio.wait_for() zwróci tę wartość. Wyjątek zgłoszony podczas anulowania może zostać przekazany dalej. Przechwytuj wyjątek możliwie blisko operacji, której niepowodzenie potrafisz obsłużyć.

Identyfikatory objęte tym wpisem: TimeoutError / asyncio.TimeoutError.

Przykłady

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())

Wynik

True
Timed out

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła