Skip to content

HttpRouter.onResponse ​

app.onResponse(hook) registra um callback síncrono nomeado para cada resposta servida por esse roteador. Registre-o na configuração do servidor antes de app.listen(...), e não dentro de uma rota.

Assinatura ​

tyrus
app.onResponse(hook: (access: HttpAccessLog) => void): void

O callback roda uma vez quando o servidor termina de produzir ou descarta o corpo da resposta. Isso inclui uma resposta StreamBody. Ele observa o status final e a duração, mas não pode alterar a resposta e não é um preHandler de rota.

tyrus
import { createRouter, HttpAccessLog, HttpError, HttpRouter } from "tyrus:http";
import { Duration } from "tyrus:temporal";

function recordAccess(access: HttpAccessLog): void {
    const elapsed: Duration = access.duration;
    console.log(access.requestId, access.status);
    console.log("assert:", access.status);
}

const app: HttpRouter = createRouter();
app.onResponse(recordAccess);

try {
    app.listen(3000);
} catch (error: HttpError) {
    console.error(error.code);
}

É permitido registrar mais de um hook. Os hooks rodam na ordem de registro. O callback pode realizar qualquer trabalho síncrono permitido pela aplicação, como atualizar uma métrica, gravar um registro de auditoria ou encaminhar dados para um adaptador de tracing.

error

tyrus
import { createRouter, HttpAccessLog, HttpRouter } from "tyrus:http";

const app: HttpRouter = createRouter();
app.onResponse((access: HttpAccessLog): void => {}); 

O hook precisa ser uma função nomeada. Um callback nomeado oferece ao servidor um ponto de entrada nativo estável e impede que uma closure sobreviva ao estado de rota que ela capturou.