TsgcHTTP3Client › Métodos › Trace

Trace Method

Envia uma requisição HTTP/3 TRACE síncrona e retorna o corpo da resposta.

Sintaxe

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

Parâmetros

NameTypeDescrição
aURLconst stringURL absoluta para a qual a requisição TRACE é enviada.
aResponseContentTStreamStream que recebe o corpo bruto da resposta (apenas sobrecarga de stream).

Valor de retorno

Corpo da resposta recebido do servidor, decodificado como string. A sobrecarga de stream grava o corpo em aResponseContent. (string)

Observações

Trace realiza um teste de loopback de mensagem ao longo do caminho até o recurso alvo: um servidor compatível ecoa a requisição recebida de volta no corpo da resposta, o que é útil para diagnosticar o que os intermediários alteram ao longo do caminho. A chamada bloqueia até que a resposta HTTP/3 completa seja recebida. Muitos servidores desativam TRACE por razões de segurança e respondem com 405 Method Not Allowed. Para uma requisição não bloqueante, use TraceAsync, que entrega a resposta pelo evento OnResponse.

Exemplo


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

Voltar para Métodos