Skip to content

isCancelled ​

isCancelled responde si a la tarea en ejecución le han pedido que pare.

FirmaisCancelled(): boolean

Solo puede usarse dentro de una función async, porque la respuesta es sobre la tarea que se está ejecutando.

La cancelación es cooperativa: surte efecto en un punto de suspensión. Una tarea que pasa mucho tiempo calculando no alcanza ninguno, y por eso nunca se interrumpe. Eso es consecuencia del diseño y no un agujero en él, y es lo que un bucle así usa para pararse solo.

tyrus
import { cancel, isCancelled, sleepAsync } from "tyrus:task";

const compute = async (): Promise<i64> => {
    let total: i64 = 0;
    for (let round: i32 = 0; round < 500; round += 1) {
        for (let i: i64 = 0; i < 200_000; i += 1) {
            total += i;
        }
        // Checked after the expensive part and before suspending again, which
        // is where a loop can stop itself rather than be interrupted.
        if (isCancelled()) {
            console.log("stopped itself");
            console.log("assert:", "stopped itself");
            return total;
        }
        await sleepAsync(1);
    }
    return total;
};

const main = async (): Promise<void> => {
    const work: Promise<i64> = compute();
    cancel(work, "stop");
    try {
        await work;
    } catch (error: Error) {
        console.log(error.message);
        console.log("assert:", "stop");
    }
};

Parar así sigue siendo una cancelación. Un valor que la tarea devuelva tras ver la petición no se convierte en el valor de la Promise: el trabajo al que ya se le dijo que parara no llega a informar de un resultado.