【JSリファレンス】Promise.reject()

更新日：2024/06/14

Promise.reject()は、Promiseコンストラクターのメソッドです。

状態が rejected（拒否）へ遷移済みのPromiseオブジェクトを生成して返します。

 

■構文


Promise.reject ( r )
  1. r: rejected値
生成されたPromiseオブジェクト

引数r が Promiseオブジェクトの場合、Promise.resolve()は引数rをそのまま返します。
しかし Promise.reject()は、新しいPromiseオブジェクトを生成して返します。

 

■備考

Promise.reject()は、new Promise()のコールバック関数で、reject()の呼び出しのみを行うコードと同等です。

  // reject()の呼び出しのみを行う
new Promise( 
      (resolve,reject)=>reject( "reject!!" )
).catch( e=>console.log(`catch() : ${e}` ) );
  // 結果: catch() : reject!!

  // 上のコードと同等コード
Promise.reject( "reject!!" )
  .catch( e=>console.log(`catch() : ${e}` ) );
  // 結果: catch() : reject!!

 

■使用例

次のコードはthen()のonFulfilledハンドラーで、rejectしています。
その結果、後で続くcatch()のonRejectedハンドラーで捕捉可能となっています。

new Promise( (resoleve)=>resoleve( 100 ))
.then( e=> Promise.reject(e) )
.catch( e=>console.log(`catch() : ${e}` ) );
// 結果:
// catch() : 100

更新日：2024/06/14

書いた人（管理人）：けーちゃん

スポンサーリンク

記事の内容について

null

こんにちはけーちゃんです。
説明するのって難しいですね。

「なんか言ってることおかしくない？」
たぶん、こんなご意見あると思います。

裏付けを取りながら記事を作成していますが、僕の勘違いだったり、そもそも情報源の内容が間違えていたりで、正確でないことが多いと思います。
そんなときは、ご意見もらえたら嬉しいです。

掲載コードについては事前に動作確認をしていますが、貼り付け後に体裁を整えるなどをした結果動作しないものになっていることがあります。
生暖かい視線でスルーするか、ご指摘ください。

ご意見、ご指摘はこちら。
https://jsref.affi-sapo-sv.com/info.php

 

このサイトは、リンクフリーです。大歓迎です。