CKTIS / Python
TimeoutError / asyncio.TimeoutError — superación de un límite de tiempo
TimeoutError indica que una operación ha superado su límite de tiempo. En Python 3.14, asyncio.TimeoutError es un alias obsoleto de la misma clase, no una excepción distinta. Captura TimeoutError y distingue un tiempo de espera agotado de la cancelación normal de una tarea.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
try:
async with asyncio.timeout(seconds):
await operation()
except TimeoutError:
...El TimeoutError integrado es una subclase de OSError; en las funciones del sistema, corresponde al error errno.ETIMEDOUT. Los mecanismos de límite de tiempo de asyncio también lo utilizan. Que una operación tarde mucho no provoca esta excepción automáticamente: el límite debe proceder de la API utilizada o de su configuración.
Desde Python 3.11, asyncio.TimeoutError es un alias obsoleto del TimeoutError integrado. En Python 3.14, asyncio.TimeoutError is TimeoutError da como resultado True. En el código nuevo, usa except TimeoutError:; no necesitas dos bloques de gestión para estos nombres.
asyncio.timeout(seconds) cancela la tarea actual cuando se agota el límite y transforma el asyncio.CancelledError resultante en TimeoutError al salir del contexto. Por eso, coloca el except que lo gestiona fuera del bloque async with. La cancelación normal de una tarea es un caso distinto; no ocultes asyncio.CancelledError dentro de la operación.
Cuando se agota el tiempo, asyncio.wait_for() solicita la cancelación de la operación a la que está esperando. Espera a que termine la cancelación, por lo que el tiempo total de espera puede superar el límite especificado. Si la operación se interrumpe como consecuencia de esa cancelación, asyncio.wait_for() lanza TimeoutError. En cambio, si la corrutina captura asyncio.CancelledError y devuelve un valor, asyncio.wait_for() devuelve ese valor. Una excepción lanzada durante la cancelación puede propagarse. Captura la excepción lo más cerca posible de la operación cuyo fallo puedas gestionar.
Identificadores de referencia incluidos en esta entrada: TimeoutError / asyncio.TimeoutError.
Ejemplos
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())Resultado
True Timed out
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.