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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.