race
race resolve ou rejeita para o JoinHandle<T> de um array que se estabelecer primeiro.
Assinatura
race<T>(handles: JoinHandle<T>[]): Promise<T>Assim que um handle se estabelece, race cancela cooperativamente todo o resto através do mesmo mecanismo de cancel/JoinHandle<T>.abort(), um handle que já se estabeleceu até então (o próprio vencedor, ou um perdedor que por acaso terminou entre a corrida se resolver e essa limpeza rodar) é deixado quieto, já que cancelar uma Promise já estabelecida é um no-op inofensivo. Todo handle passado para race é consumido do mesmo jeito que .join() consome um, reusar um handle já passado para race, para joinAll, ou para seu próprio .join(), é rejeitado em tempo de compilação (E3033).
tyrus
import { spawn, race, sleepAsync } from "tyrus:task";
async function fetchReplica(id: i32, delayMs: u64): Promise<i32> {
await sleepAsync(delayMs);
return id;
}
async function main(): Promise<void> {
// Two redundant replicas answer the same request; `race` returns
// whichever answers first and cancels the other one, no need to wait
// for a reply nothing will use.
const replicaA = spawn(async (): Promise<i32> => await fetchReplica(1, 50));
const replicaB = spawn(async (): Promise<i32> => await fetchReplica(2, 5));
const winner: i32 = await race([replicaA, replicaB]);
print(winner);
}