Connectum API Reference / @connectum/interceptors / errorHandler / createErrorHandlerInterceptor

Function: createErrorHandlerInterceptor()

createErrorHandlerInterceptor(options?): Interceptor

Defined in: errorHandler.ts:48

Create error handler interceptor

Catches all errors and transforms them into ConnectError instances with proper error codes. Recognizes SanitizableError for safe client-facing messages while preserving server details for logging.

IMPORTANT: This interceptor should be FIRST in the chain to catch all errors.

Parameters

options?

ErrorHandlerOptions = {}

Error handler options

Returns

Interceptor

ConnectRPC interceptor

Example

import { createServer } from '@connectum/core';
import { createErrorHandlerInterceptor } from '@connectum/interceptors';
import { myRoutes } from './routes.js';

const server = createServer({
  services: [myRoutes],
  interceptors: [
    createErrorHandlerInterceptor({
      onError: ({ error, code, serverDetails, stack }) => {
        logger.error('RPC error', { error: error.message, code, serverDetails, stack });
      },
    }),
  ],
});

await server.start();