Skip to content

race ​

race resuelve o rechaza con el JoinHandle<T> de un array que se asienta primero.

Firmarace<T>(handles: JoinHandle<T>[]): Promise<T>

En cuanto un handle se asienta, race cancela cooperativamente todos los demás a través del mismo mecanismo de cancel/JoinHandle<T>.abort(), un handle que ya se asentó para entonces (el propio ganador, o un perdedor que terminó justo entre que la carrera se asienta y esta limpieza corre) se deja tranquilo, ya que cancelar una Promise ya asentada es un no-op inofensivo. Todo handle pasado a race se consume igual que .join() consume uno, reutilizar un handle ya pasado a race, a joinAll, o a su propio .join(), se rechaza en tiempo de compilación (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);
}