CKTIS / Python
TimeoutError / asyncio.TimeoutError — prekoračitev časovne omejitve
TimeoutError sporoča, da je operacija presegla časovno omejitev. V Pythonu 3.14 je asyncio.TimeoutError zastarel vzdevek istega razreda in ne ločena izjema. Ujemite TimeoutError in ločite prekoračitev časovne omejitve od običajnega preklica opravila.
Različica: Python 3.14; repository image, production runtime not attested
Sintaksa
try:
async with asyncio.timeout(seconds):
await operation()
except TimeoutError:
...Vgrajeni TimeoutError je podrazred OSError; pri sistemskih funkcijah ustreza napaki errno.ETIMEDOUT. Uporabljajo ga tudi mehanizmi za časovne omejitve v asyncio. Dolgotrajna operacija te izjeme ne sproži samodejno: omejitev mora izhajati iz uporabljenega API-ja ali njegove konfiguracije.
Od Pythona 3.11 je asyncio.TimeoutError zastarel vzdevek vgrajenega TimeoutError. V Pythonu 3.14 izraz asyncio.TimeoutError is TimeoutError vrne True. V novi kodi uporabite except TimeoutError:; za ti imeni ne potrebujete dveh obravnav.
asyncio.timeout(seconds) ob poteku omejitve prekliče trenutno opravilo in nastali asyncio.CancelledError ob izhodu iz konteksta pretvori v TimeoutError. Zato postavite obravnavni except zunaj bloka async with. Običajni preklic opravila je ločen primer; znotraj operacije ne prezrite asyncio.CancelledError.
Ko se časovna omejitev izteče, asyncio.wait_for() zahteva preklic operacije, na katero čaka. Počaka, da se preklic konča, zato lahko skupni čas čakanja preseže navedeno omejitev. Če se operacija zaradi preklica konča, asyncio.wait_for() sproži TimeoutError. Če pa korutina, na katero čaka, ujame asyncio.CancelledError in vrne vrednost, asyncio.wait_for() vrne to vrednost. Izjema, sprožena med preklicem, se lahko razširi naprej. Izjemo ujemite čim bližje operaciji, katere napako lahko obravnavate.
Referenčni identifikatorji, zajeti v tem geslu: TimeoutError / asyncio.TimeoutError.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.