CKTIS / JavaScript
Promise.race — primo esito
Promise.race(iterable) restituisce una promessa che adotta il valore di adempimento o il motivo di rifiuto del primo esito elaborato. Non attende il primo successo e non annulla le altre operazioni.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
Promise.race(iterable)Promise.race(iterable) è un metodo statico che accetta un iterabile sincrono, per esempio un array. Ogni elemento viene elaborato tramite Promise.resolve: può essere una promessa, un oggetto con un metodo then oppure un valore ordinario.
Il risultato adotta il primo adempimento o rifiuto elaborato. Un rifiuto può quindi prevalere su un successo. Se tutti gli elementi sono valori ordinari senza un metodo then invocabile o promesse native già adempiute o rifiutate che Promise.resolve restituisce invariate, l’ordine di iterazione determina il vincitore. Tuttavia, Promise.resolve può racchiudere una promessa nativa già adempiuta o rifiutata di un altro ambiente ECMAScript (realm) in una nuova promessa, aggiungendo passaggi asincroni per adottarne lo stato. Un valore ordinario o una promessa già adempiuta o rifiutata dello stesso ambiente può quindi vincere anche se compare più avanti nell’iterazione. I gestori del risultato vengono comunque eseguiti in modo asincrono.
Promise.race([]) rimane in attesa per sempre. Un errore durante il recupero dell’iteratore o durante l’iterazione causa il rifiuto del risultato. Il metodo non annulla le operazioni perdenti: per fermarle serve un meccanismo separato.
Nell’esempio, pending rimane sempre in attesa. Promise.resolve restituisce invariate le altre due promesse. Quella rifiutata precede quella adempiuta, quindi il risultato è rejected: failed. La riga sync compare prima perché il gestore passato a then non viene eseguito nello stack di chiamate corrente.
Esempi
const pending = new Promise(() => {});
const result = Promise.race([
pending,
Promise.reject("failed"),
Promise.resolve("ready")
]);
result.then(
value => console.log("fulfilled: " + value),
reason => console.log("rejected: " + reason)
);
console.log("sync");Risultato
sync rejected: failed
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.