Apex サーバ側コントローラからエラーを返す

エラーの発生は避けられません。ユーザによる無効な入力、データベース内の重複レコードなど、一部のエラーは予期できます。一方、予期しないエラーが発生する場合もあります。少しでもプログラミングの経験があれば、予期せぬエラーの範囲はほぼ無限であることをご存じでしょう。

サーバ側コントローラのコードでエラーが発生した場合、2 つの対処方法が考えられます。そこでエラーをキャッチして、Apex でエラーを処理できます。それ以外の場合、エラーはコントローラの応答で戻されます。

Apex でエラーを処理するときにも、2 つの対処方法が考えられます。エラーを処理し、可能であれば復旧し、通常の応答をクライアントに返すことができます。または、AuraHandledException を作成してスローできます。

システム例外を返す代わりに AuraHandledException をスローする利点は、クライアントのコードで例外をより適切に処理できるという点です。システム例外はセキュリティ上の理由により重要な詳細情報が取り除かれるため、不安を煽る「内部サーバエラーが発生しました…」というメッセージになります。このメッセージは誰も好みません。AuraHandledException を使用すると、クライアント側のコードに返される応答にいくつかの詳細情報を追加できます。さらに良いことには、より適切なメッセージをユーザに表示できます。