CKTIS / Python
TimeoutError / asyncio.TimeoutError — ultrapassagem de um limite de tempo
TimeoutError indica que uma operação ultrapassou o seu limite de tempo. No Python 3.14, asyncio.TimeoutError é um alias obsoleto da mesma classe, não uma exceção distinta. Capture TimeoutError e distinga um tempo limite excedido do cancelamento normal de uma tarefa.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
try:
async with asyncio.timeout(seconds):
await operation()
except TimeoutError:
...O TimeoutError integrado é uma subclasse de OSError; para funções do sistema, corresponde ao erro errno.ETIMEDOUT. Os mecanismos de limite de tempo de asyncio também o utilizam. Uma operação demorada não gera esta exceção automaticamente: o limite tem de ser definido pela API utilizada ou pela respetiva configuração.
Desde o Python 3.11, asyncio.TimeoutError é um alias obsoleto do TimeoutError integrado. No Python 3.14, asyncio.TimeoutError is TimeoutError avalia para True. No código novo, utilize except TimeoutError:; não precisa de dois handlers para estes nomes.
asyncio.timeout(seconds) cancela a tarefa atual quando o limite expira e transforma o asyncio.CancelledError resultante em TimeoutError ao sair do contexto. Por este motivo, coloque o except que o trata fora do bloco async with. O cancelamento normal de uma tarefa é um caso distinto; não suprima asyncio.CancelledError dentro da operação.
Quando o tempo limite expira, asyncio.wait_for() pede o cancelamento da operação pela qual está a aguardar. Aguarda que o cancelamento termine, pelo que o tempo total de espera pode ultrapassar o limite especificado. Se a operação for interrompida em consequência desse cancelamento, asyncio.wait_for() lança TimeoutError. Se, por outro lado, a corrotina aguardada capturar asyncio.CancelledError e devolver um valor, asyncio.wait_for() devolve esse valor. Uma exceção lançada durante o cancelamento pode propagar-se. Capture a exceção tão perto quanto possível da operação cuja falha consegue tratar.
Identificadores de referência abrangidos por esta entrada: TimeoutError / asyncio.TimeoutError.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.