База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

TimeoutError / asyncio.TimeoutError — надвишаване на времеви лимит

TimeoutError сигнализира, че дадена операция е надвишила времевия си лимит. В Python 3.14 asyncio.TimeoutError е остарял псевдоним на същия клас, а не отделно изключение. Обработвайте TimeoutError и различавайте изтичането на времето от обикновеното отменяне на задача.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

try:
    async with asyncio.timeout(seconds):
        await operation()
except TimeoutError:
    ...

Вграденият TimeoutError е подклас на OSError; за системните функции той съответства на грешката errno.ETIMEDOUT. Механизмите за времеви лимити в asyncio също го използват. Операция, която продължава дълго, не поражда това изключение автоматично: лимитът трябва да е зададен от използвания API или от конфигурацията му.

От Python 3.11 asyncio.TimeoutError е остарял псевдоним на вградения TimeoutError. В Python 3.14 изразът asyncio.TimeoutError is TimeoutError се оценява до True. В нов код използвайте except TimeoutError:; не са ви необходими два обработчика за тези имена.

asyncio.timeout(seconds) отменя текущата задача, когато лимитът изтече, и преобразува произтичащия asyncio.CancelledError в TimeoutError при излизане от контекста. Затова поставете обработващия except извън блока async with. Обикновеното отменяне на задача е отделен случай; не потискайте asyncio.CancelledError вътре в операцията.

Когато времевият лимит изтече, asyncio.wait_for() заявява отмяна на операцията, която изчаква. Функцията изчаква отмяната да приключи, така че общото време за изчакване може да надвиши зададения лимит. Ако операцията бъде прекратена вследствие на тази отмяна, asyncio.wait_for() повдига TimeoutError. Ако обаче корутината, която се изчаква, прихване asyncio.CancelledError и върне стойност, asyncio.wait_for() връща тази стойност. Изключение, повдигнато по време на отмяната, може да се разпространи нагоре. Обработвайте изключението възможно най-близо до операцията, чийто неуспех можете да обработите.

Референтни идентификатори, обхванати в тази статия: TimeoutError / asyncio.TimeoutError.

Примери

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())

Резултат

True
Timed out

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници