TsgcHTTP3Client › Méthodes › Trace

Trace Méthode

Envoie une requête HTTP/3 TRACE synchrone et retourne le corps de la réponse.

Syntaxe

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

Paramètres

NomTypeDescription
aURL const stringURL absolue vers laquelle la requête TRACE est envoyée.
aResponseContentTStream Flux qui reçoit le corps brut de la réponse (surcharge flux uniquement).

Valeur de retour

Corps de la réponse reçu du serveur, décodé sous forme de chaîne. La surcharge flux écrit le corps dans aResponseContent à la place. (string)

Remarques

Trace effectue un test de bouclage de message le long du chemin vers la ressource cible : un serveur conforme renvoie la requête reçue dans le corps de la réponse, ce qui est utile pour diagnostiquer ce que les intermédiaires modifient en chemin. L'appel se bloque jusqu'à la réception complète de la réponse HTTP/3. De nombreux serveurs désactivent TRACE pour des raisons de sécurité et répondent par 405 Method Not Allowed. Pour une requête non bloquante, utilisez TraceAsync, qui livre la réponse via OnResponse.

Exemple


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

Retour aux méthodes