TsgcHTTP3Client › メソッド › Trace

Trace メソッド

同期 HTTP/3 TRACE リクエストを送信し、レスポンスボディを返します。

構文

function Trace(const aURL: string): string; overload;
procedure Trace(const aURL: string; const aResponseContent: TStream); overload;

パラメータ

名前	タイプ	説明
aURL	const string	TRACE リクエストの送信先の絶対 URL。
aResponseContent	TStream	生のレスポンスボディを受け取るストリーム（ストリームオーバーロードのみ）。

戻り値

サーバーから受信したレスポンスボディ（文字列としてデコード済み）。ストリームオーバーロードは代わりに aResponseContent にボディを書き込みます。（string）

解説

Trace は、ターゲットリソースへのパスに沿ってメッセージのループバックテストを実行します。準拠したサーバーは受信したリクエストをレスポンスボディにエコーバックし、これは経路上で中間者が何を変更するかを診断するのに役立ちます。この呼び出しは完全な HTTP/3 レスポンスが受信されるまでブロックします。多くのサーバーはセキュリティ上の理由で TRACE を無効にし、405 Method Not Allowed で応答します。ノンブロッキングリクエストには TraceAsync を使用してください。返信は OnResponse で通知されます。

使用例

vResponse := oClient.Trace('https://api.example.com/v1/users');

メソッドに戻る