Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Promise.reject — creare una promise rifiutata

Promise.reject(reason) crea una nuova promise rifiutata con il motivo fornito. I gestori del rifiuto vengono eseguiti in modo asincrono, anche se la promise restituita è già rifiutata quando viene restituita.

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.reject(reason)

Promise.reject(reason) è un metodo statico del costruttore Promise. Restituisce una nuova promise nello stato rifiutato, con reason come motivo del rifiuto. Il motivo può essere un valore qualsiasi; se l’argomento viene omesso, si usa undefined. Per gli errori, è preferibile usare un oggetto Error.

Il metodo non adotta lo stato di una promise fornita né quello di un oggetto con un metodo then (un thenable). L’argomento stesso diventa il motivo del rifiuto. A differenza di Promise.resolve, Promise.reject non restituisce invariata una promise fornita.

Una normale chiamata a Promise.reject(reason) non è un throw sincrono: un try...catch che la racchiude non intercetta il rifiuto in sé. Usa .catch(...) oppure un try...catch intorno ad await. I gestori delle promise vengono eseguiti solo dopo la fine del codice sincrono corrente. Gestisci i rifiuti; la risposta a un rifiuto non gestito dipende dall’ambiente host.

Nell’esempio, sync compare prima che venga eseguito il gestore del rifiuto e true conferma che il motivo mantiene la propria identità. Chiama il metodo come Promise.reject(...): il suo this deve essere un costruttore compatibile con le convenzioni del costruttore Promise, quindi una chiamata distaccata senza il ricevitore corretto può generare un TypeError.

Esempi

const reason = new Error("Invalid input");
const rejected = Promise.reject(reason);

rejected.catch((error) => {
  console.log(error === reason);
  console.log(error.message);
});

console.log("sync");

Risultato

sync
true
Invalid input

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