TsgcWebSocketServer_HTTPAPI › イベント › OnError

OnError イベント

不正な形式のハンドシェイクなど、WebSocketプロトコルエラーが発生するたびに発生します。

構文

property OnError: TsgcWSErrorEvent;
// TsgcWSErrorEvent = procedure(Connection: TsgcWSConnection; const Error: string) of object

デフォルト値

—

解説

OnError は WebSocket レイヤーがクライアント接続で検出したプロトコルレベルの問題を報告します。例えば不正なハンドシェイク、無効なフレーム、サポートされていないオペコード、または Options.ValidateUTF8 が有効な場合の無効な UTF-8 ペイロードなどです。Error パラメータにはテキストの説明が含まれ、Connection パラメータは問題のあるセッションを識別します。未処理のランタイム例外 (HTTP.SYS の障害、アクセス違反など) には代わりに OnException イベントが発生します。

使用例

procedure OnError(Connection: TsgcWSConnection; const Error: string);
begin
  WriteLn('#error on ' + Connection.Guid + ': ' + Error);
end;

イベントに戻る