TsgcHTTP3Client › Metody › Trace
Wysyła synchroniczne żądanie HTTP/3 TRACE i zwraca treść odpowiedzi.
function Trace(const aURL: string): string; overload;
procedure Trace(const aURL: string; const aResponseContent: TStream); overload;
| Nazwa | Typ | Opis |
|---|---|---|
aURL | const string | Bezwzględny adres URL, pod który wysyłane jest żądanie TRACE. |
aResponseContent | TStream | Strumień odbierający surową treść odpowiedzi (tylko przeciążenie strumieniowe). |
Treść odpowiedzi otrzymana od serwera, zdekodowana jako ciąg znaków. Przeciążenie strumieniowe zapisuje treść do aResponseContent. (string)
Trace przeprowadza test pętli wiadomości wzdłuż ścieżki do zasobu docelowego: zgodny serwer odsyła odebrane żądanie z powrotem w treści odpowiedzi, co jest przydatne do diagnozy, jakie zmiany wprowadzają pośrednicy po drodze. Wywołanie blokuje do czasu otrzymania pełnej odpowiedzi HTTP/3. Wiele serwerów wyłącza TRACE ze względów bezpieczeństwa i odpowiada kodem 405 Method Not Allowed. W przypadku żądania nieblokującego użyj TraceAsync, które dostarcza odpowiedź przez OnResponse.
vResponse := oClient.Trace('https://api.example.com/v1/users');