Skip to content

HttpRouter.onResponse ​

app.onResponse(hook) registra un callback síncrono con nombre para cada respuesta servida por ese router. Regístrelo en la configuración del servidor antes de app.listen(...), y no dentro de una ruta.

Firma ​

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

El callback se ejecuta una vez cuando el servidor termina de producir o descarta el cuerpo de la respuesta. Esto incluye una respuesta StreamBody. Observa el estado final y la duración, pero no puede cambiar la respuesta y no es un preHandler de ruta.

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);
}

Se permite registrar más de un hook. Los hooks se ejecutan en el orden de registro. El callback puede realizar cualquier trabajo síncrono permitido por la aplicación, como actualizar una métrica, escribir un registro de auditoría o reenviar datos a un adaptador de tracing.

error

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

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

El hook debe ser una función con nombre. Un callback con nombre proporciona al servidor un punto de entrada nativo estable e impide que una closure sobreviva al estado de ruta que capturó.