Error Filters

Server Enviroment
Client Enviroment

Overview

Error filters can be used to handle errors thrown by guards, pipes, interceptors and handlers.

Creating an Error Filter

Error filters are classes that implement the ErrorFilter interface. The ErrorFilter interface has a catch method that returns the transformed data.

@Catch() // Will catch all errors, if no error types are specified
@Injectable()
export class MangoSpoilFilter implements ErrorFilter {
    public catch(error: unknown, context: ExecurtionContext) {
        console.log('Mango is spoiled!');
        context.response?.send('Mango is spoiled!');
    }
}
typescript

The error filter can take several different error types as arguments. The error filter is only executed if the error thrown is an instance of one of the error types. If no error types are specified, the error filter is executed for all errors.

Using an Error Filter

Error filters can be used at the module, controller or handler level. To use an error filter, use the @UseErrorFilters decorator on the module, controller or handler, and pass the error filter class as an argument.

NOTE
  • When you specify an error filter as a class reference, it is instantiated as a singleton by the dependency injection container. This means that the same instance is used for all requests. If you want to use a new instance for each request, you can specify an instance of the error filter instead of a class reference.
  • If you're using class references, don't forget to add the @Injectable decorator and add the guard to the providers array in the module.
+
+
@UseErrorFilters(MangoSpoilFilter) 
@Controller()
export class DeliciousMangoController {
    @UseErrorFilters(MangoSpoilFilter) 
    @On('eat')
    public onEat(@Param('mango', ColorPipe) color: 'green' | 'yellow') {
        console.log(`I am eating a ${color} mango`);
    }
}

@Module({
    controllers: [DeliciousMangoController],
    providers: [MangoSpoilFilter],
})
export class DeliciousMangoModule {}
typescript

Also, instead of providing a class reference, you can provide an instance of the error filter. However, dependency injection will not work for the error filter instance.

+
@UseErrorFilters(new MangoSpoilFilter()) 
@Module({
    controllers: [DeliciousMangoController],
})
export class DeliciousMangoModule {}
typescript
Suggest changes to this page
Last update at: 2024/06/18 19:03:08