TsgcHTTP3Client › Methoden › Trace

Trace Methode

Verstuurt een synchrone HTTP/3 TRACE-aanvraag en retourneert de antwoordbody.

Syntaxis

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

Parameters

NaamTypeBeschrijving
aURLconst stringAbsolute URL waarnaar het TRACE-verzoek wordt verstuurd.
aResponseContentTStreamStream die de ruwe antwoordtekst ontvangt (alleen stream-overbelasting).

Retourwaarde

Antwoordbody ontvangen van de server, gedecodeerd als een string. De stream-overload schrijft de body in plaats daarvan naar aResponseContent. (string)

Opmerkingen

Trace voert een berichtlusslagtest uit langs het pad naar de doelresource: een compatibele server stuurt de ontvangen aanvraag terug in de antwoordtekst, wat nuttig is voor het diagnosticeren wat tussenpersonen onderweg wijzigen. De aanroep blokkeert totdat de volledige HTTP/3-respons is ontvangen. Veel servers schakelen TRACE uit om veiligheidsredenen en antwoorden met 405 Method Not Allowed. Voor een niet-blokkerende aanvraag gebruikt u TraceAsync, dat het antwoord levert via OnResponse.

Voorbeeld


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

Terug naar methoden