TsgcHTTP3Client › Metodi › Trace

Trace Metodo

Invia una richiesta HTTP/3 TRACE sincrona e restituisce il corpo della risposta.

Sintassi

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

Parametri

NomeTipoDescrizione
aURLconst stringURL assoluto a cui viene inviata la richiesta TRACE.
aResponseContentTStreamStream che riceve il corpo grezzo della risposta (solo overload con stream).

Valore restituito

Corpo della risposta ricevuto dal server, decodificato come stringa. L'overload con stream scrive invece il corpo in aResponseContent. (string)

Note

Trace esegue un test di loop-back del messaggio lungo il percorso verso la risorsa di destinazione: un server conforme al protocollo restituisce la richiesta ricevuta nel corpo della risposta, utile per diagnosticare le modifiche apportate dagli intermediari lungo il percorso. La chiamata si blocca fino alla ricezione completa della risposta HTTP/3. Molti server disabilitano TRACE per motivi di sicurezza e rispondono con 405 Method Not Allowed. Per una richiesta non bloccante utilizzare TraceAsync, che consegna la risposta su OnResponse.

Esempio


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

Torna ai Metodi