TsgcWebSocketHTTPServer › イベント › OnException

OnException イベント

クライアント接続の処理中に未処理の例外が発生するたびに発火します。

構文

property OnException: TsgcExceptionEvent;
// TsgcExceptionEvent = procedure(Connection: TsgcWSConnection; E: Exception) of object

デフォルト値

—

解説

OnExceptionは、WebSocket側、またはHTTPリクエストのディスパッチ中（OnCommandGet/OnCommandOther、セッション管理、静的ファイル提供、HTTP/2ストリーミングなど）に、内部処理から例外がエスケープするたびに発生します。Eパラメータは例外インスタンスを公開するので、アプリケーションはメッセージをログに記録したり、特定のクラスに反応したりできます。デフォルトでは、切断によりここで例外が発生します。これらの切断関連の例外を抑制するには、Options.RaiseDisconnectExceptionsをFalseに設定してください。HTTPリクエストの場合、ハンドラーがエラーをログに記録したり握りつぶしたりしても、サーバーは依然としてクライアントに500レスポンスを返します。

使用例

procedure OnException(Connection: TsgcWSConnection; E: Exception);
begin
  WriteLn('#exception: ' + E.Message);
end;

イベントに戻る