CKTIS / JavaScript
Promise.any — il primo risultato riuscito
Promise.any accetta un oggetto iterabile e restituisce una promise che si completa con il primo risultato riuscito osservato dal metodo. I rifiuti degli input non interrompono l’attesa, a meno che vengano rifiutati tutti; in tal caso, il risultato viene rifiutato con AggregateError.
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.any(iterable)Promise.any(iterable) è un metodo statico di Promise, introdotto con ECMAScript 2021 (ES12). Accetta un oggetto iterabile sincrono, per esempio un array di promise, valori semplici o oggetti con un metodo then (thenable). I valori vengono convertiti tramite Promise.resolve; non passare funzioni aspettandoti che il metodo le esegua.
La promise restituita assume il valore del primo completamento riuscito osservato da Promise.any, che non è necessariamente quello avvenuto prima. Se passi due promise ordinarie già completate con successo e il metodo nativo Promise.resolve le restituisce entrambe invariate, vince la prima nell’ordine di iterazione, anche se si è completata dopo la seconda. Il metodo nativo Promise.resolve restituisce una promise invariata se il valore della sua proprietà constructor coincide con il valore di this nella chiamata. Non verifica da quale ambiente di esecuzione (realm) proviene la promise. Se la prima promise viene da un altro realm e ha il suo costruttore predefinito, il metodo locale Promise.resolve la avvolge in una nuova promise. Ciò ritarda la reazione al suo completamento, quindi la seconda può vincere se viene restituita invariata. Se invece la proprietà constructor della prima promise ha come valore il Promise locale, il metodo locale Promise.resolve la restituisce invariata a prescindere dalla sua provenienza. Con Promise.race, il rifiuto di un input può determinare il risultato se il metodo lo osserva prima di qualsiasi altro completamento riuscito o rifiuto. Con Promise.any, i rifiuti degli input fanno sì che il risultato venga rifiutato con AggregateError solo quando tutti gli input sono stati rifiutati, anche se c’è un solo input e viene rifiutato. Dopo un successo, il metodo non annulla le altre operazioni.
Se tutti gli input vengono rifiutati, il risultato viene rifiutato con AggregateError. Il suo array errors contiene le ragioni nell’ordine degli input, non nell’ordine dei rifiuti. Promise.any([]) restituisce una promise già rifiutata con un array errors vuoto; i gestori vengono comunque eseguiti in modo asincrono. Anche un errore durante la lettura dell’iteratore può rifiutare il risultato, senza AggregateError.
Usa questo metodo quando è sufficiente un solo risultato riuscito. Gestisci il caso in cui non si verifichi alcun successo con try/catch attorno a await oppure con .catch(). La specifica del linguaggio non conferma il supporto in uno specifico browser: verifica l’ambiente di destinazione, per esempio con typeof Promise.any === "function". La presenza di Node 24 in un repository non dimostra il supporto nei browser.
Esempi
async function main() {
const value = await Promise.any([
Promise.reject("offline"),
Promise.resolve("ready")
]);
console.log(value);
try {
await Promise.any([
Promise.reject("first"),
Promise.reject("second")
]);
} catch (error) {
console.log(error instanceof AggregateError);
console.log(JSON.stringify(error.errors));
}
}
main().catch(console.error);Risultato
ready true ["first","second"]
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.