WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen