Promise.reject()

プロミスリジェクト（非同期処理）

意味エラーでPromise生成

Promise.reject()とは？

Promise.reject()は、指定された理由で拒否されるPromiseオブジェクトを返します。

Promise.reject()の具体的な使い方

即時に拒否されるPromiseを作成する例（ブラウザ環境）

<button onclick='usePromiseReject()'>Promise.rejectの使用例</button>
<script>
function usePromiseReject() {
  const promise = Promise.reject(new Error('失敗しました'));
  promise
    .then(() => {
      alert('この処理は実行されません');
    })
    .catch((error) => {
      alert('エラーメッセージ: ' + error.message);
    });
}
</script>

'失敗しました'というメッセージを持つErrorオブジェクトで拒否されるPromiseを作成し、エラー発生時にその理由をアラートで出力する例です。thenブロックは実行されず、catchブロックが実行されます。

即時に拒否されるPromiseを作成する例（コンソール環境）

console.log('Promise.rejectの使用例');
Promise.reject(new Error('エラーが発生しました'))
  .catch(error => {
    console.log('エラー内容:', error.message);
    return 'エラー処理完了';
  })
  .then(result => {
    console.log('最終結果:', result);
  });

👇出力結果

Promise.rejectの使用例
エラー内容: エラーが発生しました
最終結果: エラー処理完了

Promise.rejectでErrorオブジェクトを拒否し、catchで処理する例です。catchブロック内でエラーを処理し、新しい値を返してthenブロックにつなげています。

Promise.reject()に関するよくある質問

Q. Promise.rejectの主な用途は？

A. Promise.rejectは、即座に拒否されるPromiseを作成するために使用します。これは、エラー状態を表現したり、非同期操作が失敗したことを示すのに便利です。

Q. throwとの違いは？

A. throwは同期的にエラーを投げますが、Promise.rejectは非同期的にエラーを処理します。Promise.rejectを使うと、エラーをPromiseチェーンの中で扱うことができ、catchブロックで捕捉できます。

Q. エラーオブジェクト以外も使える？

A. はい、Promise.rejectには任意の値を渡すことができます。ただし、エラーの理由を明確にするために、通常はErrorオブジェクトを使用することが推奨されます。これにより、スタックトレースなどの追加情報も得られます。

Promise.reject()が学べる書籍の紹介

「プログラミング単語帳」を使って、プログラミングの単語を英単語のように学習してみませんか？
プログラミング単語帳には、JavaScriptのPromise.reject()やコールバック、Promise.all()、非同期ジェネレータ、などのような実務でよく使われる単語が数百以上収録されています。
この書籍には、プログラミングの単語の意味や読み方、単語の使い方がわかる例文などが掲載されており、いつでもどこでもプログラミングの学習ができます。

よく使われる単語にだけ絞って学習することができるので、効率的にプログラミングが学習できます。