TsgcHTTP2ClientMetody › Options

Options Metoda

Wykonuje synchroniczne żądanie HTTP/2 OPTIONS w celu wykrycia opcji komunikacji dla zasobu.

Przeciążenia

Przeciążenie 1

Składnia

function Options(const aURL: string): string;

Parametry

NazwaTypOpis
aURLconst stringBezwzględny adres URL zasobu, którego możliwości są sprawdzane, lub * do sprawdzania serwera jako całości.

Wartość zwracana

Treść odpowiedzi zwróconej przez serwer jako ciąg znaków; przydatne informacje zwykle zawierają się w nagłówkach odpowiedzi. (string)

Uwagi

OPTIONS jest powszechnie używane przez przeglądarki do wstępnych zapytań CORS i przez klientów do sprawdzenia, które metody są akceptowane. Po wywołaniu należy sprawdzić Request.Headers, aby odczytać nagłówki allow, access-control-allow-* i powiązane.

Przykład

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

Przeciążenie 2

Składnia

procedure Options(Const aURL: string; const aResponseContent: TStream);

Parametry

NazwaTypOpis
aURLconst stringBezwzględny adres URL badanego zasobu.
aResponseContentconst TStreamStrumień należący do wywołującego, który odbiera treść odpowiedzi, jeśli serwer ją zwróci.

Uwagi

Wariant OPTIONS oparty na strumieniu. Należy go używać, gdy odpowiedź ma być przekierowana do dowolnego TStream zamiast zwracana jako ciąg znaków.

Przykład

oOut := TMemoryStream.Create;
try
  oClient.Options('https://api.example.com/v1/users', oOut);
finally
  oOut.Free;
end;

Powrót do metod