TsgcHTTP3Client › Événements › OnPushPromise

OnPushPromise Événement

Se déclenche lorsque le serveur annonce un push serveur avec une trame PUSH_PROMISE.

Syntaxe

property OnPushPromise: TsgcHTTP3PushPromiseEvent;
// TsgcHTTP3PushPromiseEvent = procedure(Sender: TObject; aPushId: Int64; const aHeaders: TStringList) of object

Paramètres

NomTypeDescription
SenderTObjectLe client ayant reçu la trame PUSH_PROMISE.
aPushIdInt64Identifiant du push promis, utilisé ultérieurement pour corréler la réponse pushée ou l'annuler.
aHeadersTStringListEn-têtes de requête de la ressource que le serveur entend pousser, sous forme de paires nom=valeur.

Valeur par défaut

—

Remarques

OnPushPromise est déclenché lorsque le serveur envoie une trame PUSH_PROMISE (RFC 9114 Section 7.2.5), annonçant qu'il a l'intention de pousser une ressource que le client n'a pas explicitement demandée. La liste aHeaders contient les en-têtes de requête (y compris les pseudo-en-têtes :path et :authority) décrivant la ressource promise, afin que l'application puisse décider si elle est utile. Si la ressource est déjà mise en cache ou non nécessaire, appelez CancelPush avec aPushId pour la refuser. Le push serveur n'est proposé qu'une fois que le client a augmenté la limite de push avec SetMaxPushId.

Exemple


procedure OnPushPromiseEvent(Sender: TObject; aPushId: Int64; const aHeaders: TStringList);
begin
  Log('Push promised, id: ' + IntToStr(aPushId));
end;

Retour aux événements