CKTIS / Python
TimeoutError / asyncio.TimeoutError — een tijdslimiet overschrijden
TimeoutError geeft aan dat een bewerking de tijdslimiet heeft overschreden. In Python 3.14 is asyncio.TimeoutError een verouderde alias van dezelfde klasse, geen aparte uitzondering. Vang TimeoutError op en maak onderscheid tussen een time-out en gewone taakannulering.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
try:
async with asyncio.timeout(seconds):
await operation()
except TimeoutError:
...De ingebouwde TimeoutError is een subklasse van OSError; voor systeemfuncties komt deze overeen met de fout errno.ETIMEDOUT. Ook de time-outmechanismen in asyncio gebruiken deze uitzondering. Een bewerking die lang duurt, veroorzaakt deze uitzondering niet automatisch: de limiet moet afkomstig zijn van de gebruikte API of de configuratie daarvan.
Sinds Python 3.11 is asyncio.TimeoutError een verouderde alias van de ingebouwde TimeoutError. In Python 3.14 evalueert asyncio.TimeoutError is TimeoutError tot True. Gebruik in nieuwe code except TimeoutError:; je hebt geen twee afhandelingsblokken voor deze namen nodig.
asyncio.timeout(seconds) annuleert de huidige taak zodra de limiet verstrijkt en zet de daaruit voortkomende asyncio.CancelledError bij het verlaten van de context om in TimeoutError. Plaats daarom het afhandelende except buiten het async with-blok. Gewone taakannulering is een apart geval; onderdruk asyncio.CancelledError niet binnen de bewerking.
Wanneer de tijdslimiet verstrijkt, vraagt asyncio.wait_for() om annulering van de bewerking waarop het wacht. Het wacht tot de annulering is voltooid, waardoor de totale wachttijd de opgegeven limiet kan overschrijden. Wordt de bewerking door die annulering afgebroken, dan werpt asyncio.wait_for() TimeoutError op. Vangt de coroutine waarop wordt gewacht echter asyncio.CancelledError op en geeft ze een waarde terug, dan geeft asyncio.wait_for() die waarde terug. Een uitzondering die tijdens de annulering wordt opgeworpen, kan worden doorgegeven. Vang de uitzondering zo dicht mogelijk op bij de bewerking waarvan je de fout kunt afhandelen.
Referentie-identificatoren die in dit item worden behandeld: TimeoutError / asyncio.TimeoutError.
Voorbeelden
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())Resultaat
True Timed out
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.