TsgcHTTP3Client › イベント › OnHTTP3BeforeRequest

OnHTTP3BeforeRequest イベント

リクエストが送信される直前に発生し、リクエストヘッダーのカスタマイズを可能にします。

構文

property OnHTTP3BeforeRequest: TsgcHTTP3BeforeRequestEvent;
// TsgcHTTP3BeforeRequestEvent = procedure(Sender: TObject; var Headers: TStringList) of object

パラメータ

名前	タイプ	説明
Sender	TObject	リクエストを送信しようとしているクライアント。
Headers	var TStringList	エンコードして送信されるヘッダーリスト（name=value ペア形式）。リクエストをカスタマイズするためにエントリの追加、変更、削除ができます。

デフォルト値

—

解説

OnHTTP3BeforeRequest は、クライアントがリクエストのヘッダーリストを構築した後、QPACK エンコードされてストリームに書き込まれる前に発生し、アプリケーションに送信ヘッダーをカスタマイズする機会を与えます。リストにはすでに疑似ヘッダー（:method、:scheme、:authority、:path）と標準ヘッダーが含まれています。必要に応じてカスタムヘッダーの追加、authorization トークンの挿入、または既存の値の調整を行ってください。RFC 9114 では疑似ヘッダーが通常のヘッダーより前に来ることを要求しているため、疑似ヘッダーを先頭に保持してください。

使用例

procedure OnHTTP3BeforeRequestEvent(Sender: TObject; var Headers: TStringList);
begin
  Headers.Add('authorization=Bearer mytoken');
end;

イベントに戻る