Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri