Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Python

TimeoutError / asyncio.TimeoutError — prekoračenje vremenskog ograničenja

TimeoutError označava da je operacija prekoračila svoje vremensko ograničenje. U Pythonu 3.14 asyncio.TimeoutError zastarjeli je alias iste klase, a ne zasebna iznimka. Uhvatite TimeoutError i razlikujte istek vremena od uobičajenog otkazivanja zadatka.

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

Sintaksa

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

Ugrađeni TimeoutError podklasa je OSError; za sistemske funkcije odgovara pogrešci errno.ETIMEDOUT. Koriste ga i mehanizmi vremenskog ograničenja u asyncio. Dugo trajanje operacije ne uzrokuje automatski ovu iznimku: ograničenje mora dolaziti od upotrijebljenog API-ja ili njegove konfiguracije.

Od Pythona 3.11, asyncio.TimeoutError zastarjeli je alias ugrađenog TimeoutError. U Pythonu 3.14 izraz asyncio.TimeoutError is TimeoutError daje True. U novom kodu upotrijebite except TimeoutError:; za ta imena nisu vam potrebna dva obrađivača.

asyncio.timeout(seconds) otkazuje trenutačni zadatak kada ograničenje istekne i pretvara nastali asyncio.CancelledError u TimeoutError pri izlasku iz konteksta. Zato stavite except koji ga obrađuje izvan bloka async with. Uobičajeno otkazivanje zadatka zaseban je slučaj; nemojte potiskivati asyncio.CancelledError unutar operacije.

Kad istekne vremensko ograničenje, asyncio.wait_for() traži otkazivanje operacije na koju čeka. Čeka da otkazivanje završi, pa ukupno čekanje može premašiti navedeno ograničenje. Ako se operacija prekine zbog tog otkazivanja, asyncio.wait_for() podiže TimeoutError. No ako korutina na koju se čeka uhvati asyncio.CancelledError i vrati vrijednost, asyncio.wait_for() vraća tu vrijednost. Iznimka podignuta tijekom otkazivanja može se propagirati. Uhvatite iznimku što bliže operaciji čiju pogrešku možete obraditi.

Referentni identifikatori obuhvaćeni ovim unosom: TimeoutError / asyncio.TimeoutError.

Primjeri

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

Rezultat

True
Timed out

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori