TsgcHTTP3Client › Metody › Trace

Trace Metoda

Wysyła synchroniczne żądanie HTTP/3 TRACE i zwraca treść odpowiedzi.

Składnia

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

Parametry

NazwaTypOpis
aURLconst stringBezwzględny adres URL, pod który wysyłane jest żądanie TRACE.
aResponseContentTStreamStrumień odbierający surową treść odpowiedzi (tylko przeciążenie strumieniowe).

Wartość zwracana

Treść odpowiedzi otrzymana od serwera, zdekodowana jako ciąg znaków. Przeciążenie strumieniowe zapisuje treść do aResponseContent. (string)

Uwagi

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.

Przykład


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

Powrót do metod