TsgcHTTP3Client › Événements › OnAltSvc

OnAltSvc Événement

Se déclenche lorsque le serveur retourne un en-tête Alt-Svc annonçant des services alternatifs.

Syntaxe

property OnAltSvc: TsgcAltSvcEvent;
// TsgcAltSvcEvent = procedure(Sender: TObject; const aEntries: TsgcAltSvcList) of object

Paramètres

NomTypeDescription
SenderTObjectLe client ayant reçu l'en-tête Alt-Svc.
aEntriesTsgcAltSvcListListe analysée des services alternatifs annoncés. Chaque entrée expose Protocol, Host, Port, MaxAge et Persist.

Valeur par défaut

—

Remarques

OnAltSvc est déclenché lorsqu'une réponse contient un en-tête alt-svc (RFC 7838), par lequel un serveur annonce que la même origine est également accessible via un autre protocole, hôte ou port, par exemple un endpoint HTTP/3 découvert lors d'une connexion HTTP/2. L'en-tête est analysé en un TsgcAltSvcList et chaque TsgcAltSvcEntry décrit un service alternatif : le Protocol ALPN (tel que h3), le Host et le Port, la durée de fraîcheur MaxAge en secondes et l'indicateur Persist. Utilisez cet événement pour mettre en cache l'endpoint annoncé et y acheminer les requêtes ultérieures. Une directive de suppression (alt-svc: clear) ne déclenche pas l'événement.

Exemple


procedure OnAltSvcEvent(Sender: TObject; const aEntries: TsgcAltSvcList);
var
  i: Integer;
begin
  for i := 0 to High(aEntries) do
    Log(aEntries[i].Protocol + ' @ ' + aEntries[i].Host + ':' + IntToStr(aEntries[i].Port));
end;

Retour aux événements