TsgcHTTP3Client › Métodos › Trace

Trace Método

Envía una solicitud HTTP/3 TRACE síncrona y devuelve el cuerpo de la respuesta.

Sintaxis

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

Parámetros

NombreTipoDescripción
aURLconst stringURL absoluta a la que se envía la solicitud TRACE.
aResponseContentTStreamStream que recibe el cuerpo de la respuesta sin procesar (solo en la sobrecarga de stream).

Valor de Retorno

Cuerpo de la respuesta recibido del servidor, decodificado como una cadena. La sobrecarga de stream escribe el cuerpo en aResponseContent en su lugar. (string)

Observaciones

Trace realiza una prueba de bucle de retorno del mensaje a lo largo de la ruta hacia el recurso de destino: un servidor conforme devuelve la solicitud recibida en el cuerpo de la respuesta, lo cual es útil para diagnosticar qué modifican los intermediarios a lo largo del camino. La llamada se bloquea hasta que se ha recibido la respuesta HTTP/3 completa. Muchos servidores deshabilitan TRACE por motivos de seguridad y responden con 405 Method Not Allowed. Para una solicitud no bloqueante use TraceAsync, que entrega la respuesta en OnResponse.

Ejemplo


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

Volver a Métodos