Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

asyncio.wait_for

Espera por uma operação com limite em segundos ou indefinidamente com None.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

await asyncio.wait_for(aw, timeout)

Espera por uma operação com limite em segundos ou indefinidamente com None.

Ao expirar pede o cancelamento e aguarda o seu tratamento, pelo que a limpeza pode exceder o limite. O cancelamento propagado gera TimeoutError, mas se for capturado e devolvido um valor pode receber-se esse valor.

Aqui zero cancela a tarefa e a segunda chamada devolve 9.

import asyncio
async def main():
    start = asyncio.Event()
    async def recover():
        start.set()
        try:
            await asyncio.Event().wait()
        except asyncio.CancelledError:
            return 7
    t = asyncio.create_task(recover())
    await start.wait()
    assert await asyncio.wait_for(t, 0) == 7
    assert await asyncio.wait_for(asyncio.sleep(0, result=9), None) == 9
asyncio.run(main())

Exemplos

import asyncio

async def main():
    task = asyncio.create_task(asyncio.Event().wait())
    try:
        await asyncio.wait_for(task, timeout=0)
    except TimeoutError:
        print(task.cancelled())
    print(await asyncio.wait_for(asyncio.sleep(0, result=9), timeout=5))

asyncio.run(main())

Resultado

True
9

Aqui zero cancela a tarefa e a segunda chamada devolve 9.

Fontes