Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti