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');

返回方法