TsgcHTTP3Client › Eventos › OnPushPromise

OnPushPromise Evento

É disparado quando o servidor anuncia um server push com um frame PUSH_PROMISE.

Sintaxe

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

Parâmetros

NameTypeDescrição
SenderTObjectO cliente que recebeu o frame PUSH_PROMISE.
aPushIdInt64Identificador do push prometido, usado posteriormente para correlacionar a resposta enviada por push ou cancelá-lo.
aHeadersTStringListCabeçalhos de requisição do recurso que o servidor pretende enviar por push, como pares nome=valor.

Valor Padrão

—

Observações

OnPushPromise é disparado quando o servidor envia um frame PUSH_PROMISE (RFC 9114 Seção 7.2.5), anunciando que pretende enviar por push um recurso que o cliente não solicitou explicitamente. A lista aHeaders contém os cabeçalhos de requisição (incluindo os pseudo-cabeçalhos :path e :authority) descrevendo o recurso prometido, para que a aplicação possa decidir se é útil. Se o recurso já estiver em cache ou não for necessário, chame CancelPush com aPushId para recusá-lo. O server push só é oferecido após o cliente ter elevado o limite de push com SetMaxPushId.

Exemplo


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

Voltar para Eventos