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.