Skip to content

race ​

race resolve ou rejeita para o JoinHandle<T> de um array que se estabelecer primeiro.

Assinaturarace<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);
}