非同期JavaScriptコードを定義する

非同期クライアントアクションを定義する

JavaScript要素では、次の2つの事前定義された関数が使用できます: "$resolve()"および"$reject()"。これらの関数は、Promiseと一緒に使用される通常のresolve()およびreject()機能に酷似していますが、$resolve()は引数を受け取りません。出力値は事前定義された$parametersオブジェクトを使用して設定する必要があります。

あるJavaScript要素で、事前定義された$resolve()または$reject()関数のどちらかが使用されている場合、その要素が属するクライアントアクションは非同期とみなされます。さらに、あるクライアントアクションにサーバーアクションの実行やAggregateの更新などのサーバー呼び出しが含まれる場合も、クライアントアクションは非同期とみなされます。

これら2つの事前定義された関数のうち1つを含む要素について生成されたコードは、Promiseの作成に囲まれています。そのため、JavaScript要素のコードに手動でPromiseを作成する必要はありません。

// Return success in GlobalAsyncAction client action
$parameters.Success = true;
$parameters.Out1 = 5.0;
$resolve();

// 1st approach: return failure in GlobalAsyncAction client action using an output parameter
$parameters.Success = false;
$parameters.ErrorMessage = "A custom error message"; 
$resolve();

// 2nd approach: return failure in GlobalAsyncAction client action using $reject(...)
$reject(new Error("A custom error message"));

非同期クライアントアクションを呼び出す

非同期クライアントアクションが呼び出されると、その戻り値は同期の場合のようにJavaScriptオブジェクトではなく、Promiseとなります。出力パラメータ値は返されたPromiseを通じて、未来に利用可能になります（最終的に利用可能にならない場合もあります）。

これらの値を処理するコードは、返されたPromiseでサポートされているthen(onFullfilled)メソッド呼び出しに含める必要があります。onFullfilled引数は、以下の例のように指定する必要があるコールバック関数です。

// call the GlobalAsyncAction asynchronous client action
$actions.GlobalAsyncAction().then(function(result) {
  $parameters.Success = result.Success;
  if (result.Success) {
    $parameters.MyOutput = result.Out1;
    console.log($parameters.MyOutput);
  }
  // if the current client action is being invoked asynchronously, this call will resolve its promise
  $resolve();
});

resultパラメータは、呼び出された非同期クライアントアクションの出力パラメータを含むオブジェクトです（出力パラメータが存在する場合）。

未処理のエラー、または非同期クライアントアクションで発生した$reject()の呼び出しに対応することもできます。これを行うには、以下の手順のいずれかを実行します。

1. 2番目の引数をthen()メソッドに追加します。このフルシグネチャはthen(onFullfilled, onRejected)であり、onRejectedは非同期アクションで$reject()が呼び出された場合に呼び出されるコールバック関数です。
2. Promiseでもあるthen()メソッドの戻り値を、エラーケースに対応するcatch(onRejected)メソッドと連鎖させます。この連鎖処理は「コンポジション」と呼ばれます。

catch(onRejected)を使用した例:

// Using this approach, success/failure is signaled through the "Success" output parameter
$actions.GlobalAsyncAction().then(function(result) {
  $parameters.Success = result.Success;
  if (result.Success) {
    $parameters.MyOutput = result.Out1;
    console.log($parameters.MyOutput);
  }
  $resolve();
}).catch(function(err) {
  // err will contain an Error object, either due to an unhandled error or to $reject(...) having been called
  $parameters.Success = false;
  $parameters.ErrorMessage = err.message;
  $resolve();
});

上記の例では、catch()コールバック関数はSuccessを「false」に設定し、ErrorMessage出力パラメータにエラーメッセージを保存して$resolve()を呼び出すことで、エラー関連データをJavaScript要素の出力パラメータとしてカプセル化しています。この場合、then()およびcatch()コールバック関数はいずれも$resolve()コールで終わります。

非同期コールが成功した場合$resolve()を使用して、catch()コールバック関数の終わりに$resolve()ではなく$reject(...)を使用する方法もあります。

// Example using the $resolve()/$reject(...) approach
$actions.GlobalAsyncAction().then(function(result) {
  $parameters.MyOutput = result.Out1;
  console.log($parameters.MyOutput);
  $resolve();
}).catch(function(err) {
  // err will contain an Error object, either due to an unhandled error in GlobalAsyncAction
  // or to $reject(...) having been called in the same action
  console.log("An error occurred in GlobalAsyncAction: " + err.message);
  $reject(err);
});

catch()で対応されない$reject(...)コールまたはエラーは、デフォルトではエラーフィードバックメッセージを作成します。これはアプリケーション画面の最上部に表示されます。

JavaScriptでの同期クライアントアクションを呼び出す場合、非同期クライアントアクションの呼び出しとは異なるコーディングを行う必要があります。

• 同期クライアントアクションを呼び出す場合、戻り値は出力パラメータを含むシンプルなJavaScriptオブジェクトです。

• 非同期クライアントアクションを呼び出す場合、Promiseが戻されます。つまり、戻り値は呼び出し側のコンテキストに返された後すぐには利用可能にはなりません。このことを念頭に置いてJavaScriptコードを作成しないと、後に続くロジックが無効なデータに基づいて作動する可能性があります。