Function handleError

shared/error.ts:191–250

(
    err: Error,
    c: Context<TEnv>,
)

const MAX_UPSTREAM_BODY_LENGTH = 16000;

export async function handleError<TEnv extends ErrorHandlerEnv>(
    err: Error,
    c: Context<TEnv>,
) {
    // Use getLogger directly instead of c.get("log"). The error handler must
    // never depend on logger middleware having run successfully — getLogger is
    // idempotent (returns the same singleton for the same category).
    const log = getLogger(["hono"]);
    const timestamp = new Date().toISOString();

    // Set the error on the context for it to be tracked
    c.set("error", err);

    if (err instanceof UpstreamError) {
        const status = err.status;
        if (status >= 500)
            await emitServerError(c, err, status, timestamp, log);
        else {
            log.trace("UpstreamError: {message}", {
                message: err.message || getDefaultErrorMessage(err.status),
            });
        }
        return c.json(
            createUpstreamErrorResponse(err, status, timestamp),
            status,
        );
    }

    if (err instanceof HTTPException) {
        const status = err.status;
        if (status >= 500)
            await emitServerError(c, err, status, timestamp, log);
        else {
            log.trace("HttpException: {message}", {
                message: err.message || getDefaultErrorMessage(err.status),
            });
        }
        return c.json(createErrorResponse(err, status, timestamp), status);
    }

    if (err instanceof APIError) {
        const status = err.statusCode as ContentfulStatusCode;
        if (status >= 500)
            await emitServerError(c, err, status, timestamp, log);
        else log.trace("APIError: {error}", { error: err });
        return c.json(createErrorResponse(err, status, timestamp), status);
    }

    if (err instanceof ValidationError) {
        const status = 400;
        const response = createValidationErrorResponse(err, status, timestamp);
        log.trace("ValidationError: {error}", { error: err });
        return c.json(response, status);
    }

    const status = 500;
    await emitServerError(c, err, status, timestamp, log);
    const response = createInternalErrorResponse(err, status, timestamp);