isCancelled
isCancelled responde se a tarefa em execução foi mandada parar.
Assinatura
isCancelled(): booleanSó pode ser usado dentro de uma função async, porque a resposta é sobre a tarefa que está rodando.
O cancelamento é cooperativo: ele tem efeito num ponto de suspensão. Uma tarefa que passa muito tempo computando não alcança nenhum, e por isso nunca é interrompida. Isso é consequência do desenho e não um buraco nele, e é o que um laço desses usa para parar sozinho.
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 assim continua sendo um cancelamento. Um valor que a tarefa retorne depois de ver o pedido não vira o valor da Promise: trabalho que já foi mandado parar não chega a reportar resultado.
