JavaScriptにおける解決済みPromiseの作成

時には、既に完了したPromiseを作成する必要があるかもしれません。そのためには2つのメソッドがあります: Promise.resolveメソッドは成功裏に解決されたPromiseを作成し、Promise.rejectメソッドは拒否されたPromiseを作成します。これらのメソッドはパラメータとして、それぞれPromiseの結果またはエラーとなるものを受け取ります。

既に完了したPromiseはいつ必要になるのでしょうか？例を見てみましょう。ある関数があり、パラメータとして数値を受け取り、非同期に何らかの処理を行い、結果のPromiseを返すとします:

javascriptfunction func(num) {
  return new Promise(function(resolve) {
    setTimeout(function() {
      resolve(num * num);
    }, 3000);
  });
}

この関数を次のように使用します:

javascriptfunc(5).then(function(res) {
  console.log(res); // 25を出力
});

ここで、渡された数値が0より大きい場合にのみ非同期操作を実行し、それ以外の場合、関数の結果は0でなければならないと決めたとします:

javascriptfunction func(num) {
  if (num > 0) {
    return new Promise(function(resolve) {
      setTimeout(function() {
        resolve(num * num);
      }, 3000);
    });
  } else {
    return 0; // ゼロ結果
  }
}

しかし、これでは関数がPromiseまたは数値を返すことになります。その結果、関数の結果にthenメソッドを適用できなくなります。なぜなら、関数が数値を返す場合、エラーが発生するからです:

javascriptfunc(0).then(function(res) { // エラー、数値0に対してthenメソッドを適用している
  
});

この問題を解決するにはPromise.resolveが役立ちます:

javascriptfunction func(num) {
  if (num > 0) {
    return new Promise(function(resolve) {
      setTimeout(function() {
        resolve(num * num);
      }, 3000);
    });
  } else {
    return Promise.resolve(0); // 数値ではなくPromiseを返す
  }
}

次に、渡された値が0の場合は0を返し、0未満の数値の場合は例外を発生させることに決めたとします。この場合、Promise.rejectメソッドが役立ちます:

javascriptfunction func(num) {
  if (num > 0) {
    return new Promise(function(resolve) {
      setTimeout(function() {
        resolve(num * num);
      }, 3000);
    });
  } else if (num === 0) {
    return Promise.resolve(0);
  } else {
    return Promise.reject('incorrect number'); // 拒否されたPromiseを返す
  }
}