JavaScript Promise の使用

ブラウザでネイティブバージョンが提供されない場合は、フレームワークがポリフィルを使用するため、プロミスは Lightning Experience でサポートされるすべてのブラウザで機能します。

ここでは、プロミスの基本を十分に理解していることを前提としています。プロミスのわかりやすい概要については、https://developers.google.com/web/fundamentals/getting-started/primers/promisesを参照してください。

プロミスは省略可能な機能です。プロミスを愛用している人もいれば、そうでない人もいます。各自の使用事例にとって有用であれば利用します。

複数のコールバックを連携させたり、まとめてチェーニングしたりする必要があるときはプロミスが役立ちます。汎用的なパターンは次のとおりです。

1somePromise()
2    .then(
3        // resolve handler
4        $A.getCallback(function(result) {
5            return anotherPromise();
6        }),
7
8        // reject handler
9        $A.getCallback(function(error) {
10            console.log("Promise was rejected: ", error);
11            return errorRecoveryPromise();
12        })
13    )
14    .then(
15        // resolve handler
16        $A.getCallback(function() {
17            return yetAnotherPromise();
18        })
19    );

somePromise() は Promise を返します。このプロミスのコンストラクタが、プロミスで resolve() または reject() をコールする条件を決定します。

then() メソッドは、複数のプロミスをチェーニングします。この例では、各解決ハンドラが別のプロミスを返します。

then() は Promise API の一部です。次の 2 つの引数を取ります。

1. 達成されたプロミスのコールバック (解決ハンドラ)
2. 却下されたプロミスのコールバック (却下ハンドラ)

1 つ目のコールバック function(result) は、プロミスコンストラクタで resolve() がコールされたときにコールされます。コールバックの result オブジェクトは、resolve() への引数として渡されるオブジェクトです。

2 つ目のコールバック function(error) は、プロミスコンストラクタで reject() がコールされたときにコールされます。コールバックの error オブジェクトは、reject() への引数として渡されるオブジェクトです。

1promise.then(...)
2    .catch(function(error) {
3        $A.reportError("error message here", error);
4    });