CKTIS / Python
asyncio.CancelledError
Meldet nach cancel() den Abbruch bei der nächsten Gelegenheit zur Fortsetzung des Tasks.
Version: Python 3.14; repository image, production runtime not attested
Syntax
except asyncio.CancelledError:Meldet nach cancel() den Abbruch bei der nächsten Gelegenheit zur Fortsetzung des Tasks.
Bewusstes Unterdrücken setzt cancelling() nicht zurück. Soll der Abbruchzustand vollständig entfernt werden, vermindert uncancel() den Zähler um eine Anforderung. Die Ausnahme erbt von BaseException und entgeht except Exception. Aufräumen gehört in finally, nach ausdrücklichem Abfangen gewöhnlich erneut auslösen.
Im Beispiel beobachtet await den Abbruch und cancelled() liefert nach dessen Weitergabe True.
import asyncio
async def main():
cleaned = []
async def worker():
try:
await asyncio.Event().wait()
finally:
cleaned.append(True)
t = asyncio.create_task(worker())
await asyncio.sleep(0)
t.cancel()
try:
await t
except asyncio.CancelledError:
assert t.cancelled() and cleaned == [True]
assert not issubclass(asyncio.CancelledError, Exception)
asyncio.run(main())
import asyncio
async def main():
t = asyncio.current_task()
t.cancel()
try:
await asyncio.sleep(0)
except asyncio.CancelledError:
assert t.cancelling() == 1 and t.uncancel() == 0
asyncio.run(main())
Beispiele
import asyncio
async def main():
task = asyncio.create_task(asyncio.sleep(60))
await asyncio.sleep(0)
task.cancel()
try:
await task
except asyncio.CancelledError:
print(task.cancelled())
asyncio.run(main())
Ergebnis
True
Im Beispiel beobachtet await den Abbruch und cancelled() liefert nach dessen Weitergabe True.