@nestjs/common

@nestjs/common

Version 10.4.7
Published 6 hours ago
429 kB
3 dependencies
MIT license

Install

npm i @nestjs/common

yarn add @nestjs/common

pnpm add @nestjs/common

Overview

Nest - modern, fast, powerful node.js web framework (@common)

Index

Variables

variable VERSION_NEUTRAL

const VERSION_NEUTRAL: Symbol;

Indicates that this will work for any version passed in the request, or no version.

Functions

function All

All: (path?: string | string[]) => MethodDecorator;

Route handler (method) Decorator. Routes all HTTP requests to the specified path.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)

function applyDecorators

applyDecorators: (
    ...decorators: Array<ClassDecorator | MethodDecorator | PropertyDecorator>
) => <TFunction extends Function, Y>(
    target: object | TFunction,
    propertyKey?: string | symbol,
    descriptor?: TypedPropertyDescriptor<Y>
) => void;

Function that returns a new decorator that applies all decorators provided by param
Useful to build new decorators (or a decorator factory) encapsulating multiple decorators related with the same feature
Parameter decorators
one or more decorators (e.g., ApplyGuard(...))

function assignMetadata

assignMetadata: <TParamtype = any, TArgs = any>(
    args: TArgs,
    paramtype: TParamtype,
    index: number,
    data?: ParamData,
    ...pipes: (Type<PipeTransform> | PipeTransform)[]
) => TArgs & {
    [x: string]: {
        index: number;
        data: ParamData;
        pipes: (PipeTransform<any, any> | Type<PipeTransform<any, any>>)[];
    };
};

function Bind

Bind: (...decorators: any[]) => MethodDecorator;

Decorator that binds *parameter decorators* to the method that follows.
Useful when the language doesn't provide a 'Parameter Decorator' feature (i.e., vanilla JavaScript).
Parameter decorators
one or more parameter decorators (e.g., Req())

function Body

Body: {
    (): ParameterDecorator;
    (
        ...pipes: (PipeTransform<any, any> | Type<PipeTransform<any, any>>)[]
    ): ParameterDecorator;
    (
        property: string,
        ...pipes: (PipeTransform<any, any> | Type<PipeTransform<any, any>>)[]
    ): ParameterDecorator;
};

Route handler parameter decorator. Extracts the entire body object from the req object and populates the decorated parameter with the value of body.
For example:
async create(@Body() createDto: CreateCatDto)
See Also
- [Request object](https://docs.nestjs.com/controllers#request-object)
Route handler parameter decorator. Extracts the entire body object from the req object and populates the decorated parameter with the value of body. Also applies the specified pipes to that parameter.
For example:
async create(@Body(new ValidationPipe()) createDto: CreateCatDto)
Parameter pipes
one or more pipes - either instances or classes - to apply to the bound body parameter.
See Also
- [Request object](https://docs.nestjs.com/controllers#request-object)
- [Working with pipes](https://docs.nestjs.com/custom-decorators#working-with-pipes)
Route handler parameter decorator. Extracts a single property from the body object property of the req object and populates the decorated parameter with the value of that property. Also applies pipes to the bound body parameter.
For example:
async create(@Body('role', new ValidationPipe()) role: string)
Parameter property
name of single property to extract from the body object
Parameter pipes
one or more pipes - either instances or classes - to apply to the bound body parameter.
See Also
- [Request object](https://docs.nestjs.com/controllers#request-object)
- [Working with pipes](https://docs.nestjs.com/custom-decorators#working-with-pipes)

function Catch

Catch: (...exceptions: Array<Type<any> | Abstract<any>>) => ClassDecorator;

Decorator that marks a class as a Nest exception filter. An exception filter handles exceptions thrown by or not handled by your application code.
The decorated class must implement the ExceptionFilter interface.
Parameter exceptions
one or more exception *types* specifying the exceptions to be caught and handled by this filter.
See Also
- [Exception Filters](https://docs.nestjs.com/exception-filters)
  Exception filters are applied using the @UseFilters() decorator, or (globally) with app.useGlobalFilters().

function Controller

Controller: {
    (): ClassDecorator;
    (prefix: string | string[]): ClassDecorator;
    (options: ControllerOptions): ClassDecorator;
};

Decorator that marks a class as a Nest controller that can receive inbound requests and produce responses.
An HTTP Controller responds to inbound HTTP Requests and produces HTTP Responses. It defines a class that provides the context for one or more related route handlers that correspond to HTTP request methods and associated routes for example GET /api/profile, POST /users/resume.
A Microservice Controller responds to requests as well as events, running over a variety of transports [(read more here)](https://docs.nestjs.com/microservices/basics). It defines a class that provides a context for one or more message or event handlers.
See Also
- [Controllers](https://docs.nestjs.com/controllers)
- [Microservices](https://docs.nestjs.com/microservices/basics#request-response)
Decorator that marks a class as a Nest controller that can receive inbound requests and produce responses.
An HTTP Controller responds to inbound HTTP Requests and produces HTTP Responses. It defines a class that provides the context for one or more related route handlers that correspond to HTTP request methods and associated routes for example GET /api/profile, POST /users/resume.
A Microservice Controller responds to requests as well as events, running over a variety of transports [(read more here)](https://docs.nestjs.com/microservices/basics). It defines a class that provides a context for one or more message or event handlers.
Parameter prefix
string that defines a route path prefix. The prefix is pre-pended to the path specified in any request decorator in the class.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)
- [Controllers](https://docs.nestjs.com/controllers)
- [Microservices](https://docs.nestjs.com/microservices/basics#request-response)
Decorator that marks a class as a Nest controller that can receive inbound requests and produce responses.
An HTTP Controller responds to inbound HTTP Requests and produces HTTP Responses. It defines a class that provides the context for one or more related route handlers that correspond to HTTP request methods and associated routes for example GET /api/profile, POST /users/resume.
A Microservice Controller responds to requests as well as events, running over a variety of transports [(read more here)](https://docs.nestjs.com/microservices/basics). It defines a class that provides a context for one or more message or event handlers.
Parameter options
configuration object specifying:
- scope - symbol that determines the lifetime of a Controller instance. [See Scope](https://docs.nestjs.com/fundamentals/injection-scopes#usage) for more details. - prefix - string that defines a route path prefix. The prefix is pre-pended to the path specified in any request decorator in the class. - version - string, array of strings, or Symbol that defines the version of all routes in the class. [See Versioning](https://docs.nestjs.com/techniques/versioning) for more details.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)
- [Controllers](https://docs.nestjs.com/controllers)
- [Microservices](https://docs.nestjs.com/microservices/basics#request-response)
- [Versioning](https://docs.nestjs.com/techniques/versioning)

function createParamDecorator

createParamDecorator: <
    FactoryData = any,
    FactoryInput = any,
    FactoryOutput = any
>(
    factory: CustomParamFactory<FactoryData, FactoryInput, FactoryOutput>,
    enhancers?: ParamDecoratorEnhancer[]
) => (
    ...dataOrPipes: (Type<PipeTransform> | PipeTransform | FactoryData)[]
) => ParameterDecorator;

Defines HTTP route param decorator
Parameter factory
Parameter enhancers

function Delete

Delete: (path?: string | string[]) => MethodDecorator;

Route handler (method) Decorator. Routes HTTP DELETE requests to the specified path.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)

function Dependencies

Dependencies: (...dependencies: Array<unknown>) => ClassDecorator;

Decorator that sets required dependencies (required with a vanilla JavaScript objects)

function flatten

flatten: <T extends unknown[] = any>(
    arr: T
) => T extends (infer R)[] ? R : never;

function forwardRef

forwardRef: (fn: () => any) => ForwardReference;

function Get

Get: (path?: string | string[]) => MethodDecorator;

Route handler (method) Decorator. Routes HTTP GET requests to the specified path.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)

function Global

Global: () => ClassDecorator;

Decorator that makes a module global-scoped.
Once imported into any module, a global-scoped module will be visible in all modules. Thereafter, modules that wish to inject a service exported from a global module do not need to import the provider module.
See Also
- [Global modules](https://docs.nestjs.com/modules#global-modules)

function Head

Head: (path?: string | string[]) => MethodDecorator;

Route handler (method) Decorator. Routes HTTP HEAD requests to the specified path.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)

Header: (name: string, value: string | (() => string)) => MethodDecorator;

Request method Decorator. Sets a response header.
For example: @Header('Cache-Control', 'none') @Header('Cache-Control', () => 'none')
Parameter name
string to be used for header name
Parameter value
string to be used for header value
See Also
- [Headers](https://docs.nestjs.com/controllers#headers)

function Headers

Headers: (property?: string) => ParameterDecorator;

Route handler parameter decorator. Extracts the headers property from the req object and populates the decorated parameter with the value of headers.
For example: async update(@Headers('Cache-Control') cacheControl: string)
Parameter property
name of single header property to extract.
See Also
- [Request object](https://docs.nestjs.com/controllers#request-object)

function HostParam

HostParam: { (): ParameterDecorator; (property: string): ParameterDecorator };

Route handler parameter decorator. Extracts the hosts property from the req object and populates the decorated parameter with the value of hosts. May also apply pipes to the bound parameter.
For example, extracting all params:
findOne(@HostParam() params: string[])
For example, extracting a single param:
findOne(@HostParam('id') id: string)
Parameter property
name of single property to extract from the req object
See Also
- [Request object](https://docs.nestjs.com/controllers#request-object)

function HttpCode

HttpCode: (statusCode: number) => MethodDecorator;

Request method Decorator. Defines the HTTP response status code. Overrides default status code for the decorated request method.
Parameter statusCode
HTTP response code to be returned by route handler.
See Also
- [Http Status Codes](https://docs.nestjs.com/controllers#status-code)

function Inject

Inject: <T = any>(token?: T) => PropertyDecorator & ParameterDecorator;

Decorator that marks a constructor parameter as a target for [Dependency Injection (DI)](https://docs.nestjs.com/providers#dependency-injection).
Any injected provider must be visible within the module scope (loosely speaking, the containing module) of the class it is being injected into. This can be done by:
- defining the provider in the same module scope - exporting the provider from one module scope and importing that module into the module scope of the class being injected into - exporting the provider from a module that is marked as global using the @Global() decorator
#### Injection tokens Can be *types* (class names), *strings* or *symbols*. This depends on how the provider with which it is associated was defined. Providers defined with the @Injectable() decorator use the class name. Custom Providers may use strings or symbols as the injection token.
Parameter token
lookup key for the provider to be injected (assigned to the constructor parameter).
See Also
- [Providers](https://docs.nestjs.com/providers)
- [Custom Providers](https://docs.nestjs.com/fundamentals/custom-providers)
- [Injection Scopes](https://docs.nestjs.com/fundamentals/injection-scopes)

function Injectable

Injectable: (options?: InjectableOptions) => ClassDecorator;

Decorator that marks a class as a [provider](https://docs.nestjs.com/providers). Providers can be injected into other classes via constructor parameter injection using Nest's built-in [Dependency Injection (DI)](https://docs.nestjs.com/providers#dependency-injection) system.
When injecting a provider, it must be visible within the module scope (loosely speaking, the containing module) of the class it is being injected into. This can be done by:
- defining the provider in the same module scope - exporting the provider from one module scope and importing that module into the module scope of the class being injected into - exporting the provider from a module that is marked as global using the @Global() decorator
Providers can also be defined in a more explicit and imperative form using various [custom provider](https://docs.nestjs.com/fundamentals/custom-providers) techniques that expose more capabilities of the DI system.
Parameter options
options specifying scope of injectable
See Also
- [Providers](https://docs.nestjs.com/providers)
- [Custom Providers](https://docs.nestjs.com/fundamentals/custom-providers)
- [Injection Scopes](https://docs.nestjs.com/fundamentals/injection-scopes)

function Ip

Ip: () => ParameterDecorator;

Route handler parameter decorator. Extracts the Ip property from the req object and populates the decorated parameter with the value of ip.
See Also
- [Request object](https://docs.nestjs.com/controllers#request-object)

function mixin

mixin: <T>(mixinClass: Type<T>) => Type<T>;

function Module

Module: (metadata: ModuleMetadata) => ClassDecorator;

Decorator that marks a class as a [module](https://docs.nestjs.com/modules).
Modules are used by Nest to organize the application structure into scopes. Controllers and Providers are scoped by the module they are declared in. Modules and their classes (Controllers and Providers) form a graph that determines how Nest performs [Dependency Injection (DI)](https://docs.nestjs.com/providers#dependency-injection).
Parameter metadata
module configuration metadata
See Also
- [Modules](https://docs.nestjs.com/modules)

function Next

Next: () => ParameterDecorator;

Route handler parameter decorator. Extracts reference to the Next function from the underlying platform and populates the decorated parameter with the value of Next.

function Optional

Optional: () => PropertyDecorator & ParameterDecorator;

Parameter decorator for an injected dependency marking the dependency as optional.
For example:
constructor(@Optional() @Inject('HTTP_OPTIONS')private readonly httpClient: T) {}
See Also
- [Optional providers](https://docs.nestjs.com/providers#optional-providers)

function Options

Options: (path?: string | string[]) => MethodDecorator;

Route handler (method) Decorator. Routes HTTP OPTIONS requests to the specified path.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)

function Param

Param: {
    (): ParameterDecorator;
    (
        ...pipes: (PipeTransform<any, any> | Type<PipeTransform<any, any>>)[]
    ): ParameterDecorator;
    (
        property: string,
        ...pipes: (PipeTransform<any, any> | Type<PipeTransform<any, any>>)[]
    ): ParameterDecorator;
};

Route handler parameter decorator. Extracts the params property from the req object and populates the decorated parameter with the value of params. May also apply pipes to the bound parameter.
For example, extracting all params:
findOne(@Param() params: string[])
For example, extracting a single param:
findOne(@Param('id') id: string)
Parameter property
name of single property to extract from the req object
Parameter pipes
one or more pipes - either instances or classes - to apply to the bound parameter.
See Also
- [Request object](https://docs.nestjs.com/controllers#request-object)
- [Working with pipes](https://docs.nestjs.com/custom-decorators#working-with-pipes)

function Patch

Patch: (path?: string | string[]) => MethodDecorator;

Route handler (method) Decorator. Routes HTTP PATCH requests to the specified path.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)

function Post

Post: (path?: string | string[]) => MethodDecorator;

Route handler (method) Decorator. Routes HTTP POST requests to the specified path.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)

function Put

Put: (path?: string | string[]) => MethodDecorator;

Route handler (method) Decorator. Routes HTTP PUT requests to the specified path.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)

function Query

Query: {
    (): ParameterDecorator;
    (
        ...pipes: (PipeTransform<any, any> | Type<PipeTransform<any, any>>)[]
    ): ParameterDecorator;
    (
        property: string,
        ...pipes: (PipeTransform<any, any> | Type<PipeTransform<any, any>>)[]
    ): ParameterDecorator;
};

Route handler parameter decorator. Extracts the query property from the req object and populates the decorated parameter with the value of query. May also apply pipes to the bound query parameter.
For example:
async find(@Query('user') user: string)
Parameter property
name of single property to extract from the query object
Parameter pipes
one or more pipes to apply to the bound query parameter
See Also
- [Request object](https://docs.nestjs.com/controllers#request-object)

function RawBody

RawBody: () => ParameterDecorator;

Route handler parameter decorator. Extracts the rawBody Buffer property from the req object and populates the decorated parameter with that value.
For example:
async create(@RawBody() rawBody: Buffer | undefined)
See Also
- [Request object](https://docs.nestjs.com/controllers#request-object)
- [Raw body](https://docs.nestjs.com/faq/raw-body)

function Redirect

Redirect: (url?: string, statusCode?: number) => MethodDecorator;

Redirects request to the specified URL.

function Render

Render: (template: string) => MethodDecorator;

Route handler method Decorator. Defines a template to be rendered by the controller.
For example: @Render('index')
Parameter template
name of the render engine template file
See Also
- [Model-View-Controller](https://docs.nestjs.com/techniques/mvc)

function Req

Req: () => ParameterDecorator;

function Request

Request: () => ParameterDecorator;

Route handler parameter decorator. Extracts the Request object from the underlying platform and populates the decorated parameter with the value of Request.
Example: logout(@Request() req)
See Also
- [Request object](https://docs.nestjs.com/controllers#request-object)

function RequestMapping

RequestMapping: (metadata?: RequestMappingMetadata) => MethodDecorator;

function Res

Res: (options?: ResponseDecoratorOptions) => ParameterDecorator;

function Response

Response: (options?: ResponseDecoratorOptions) => ParameterDecorator;

Route handler parameter decorator. Extracts the Response object from the underlying platform and populates the decorated parameter with the value of Response.
Example: logout(@Response() res)

function Search

Search: (path?: string | string[]) => MethodDecorator;

Route handler (method) Decorator. Routes HTTP SEARCH requests to the specified path.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)

function SerializeOptions

SerializeOptions: (
    options: ClassSerializerContextOptions
) => import('../../decorators').CustomDecorator<string>;

function Session

Session: () => ParameterDecorator;

Route handler parameter decorator. Extracts the Session object from the underlying platform and populates the decorated parameter with the value of Session.
See Also
- [Request object](https://docs.nestjs.com/controllers#request-object)

function SetMetadata

SetMetadata: <K = string, V = any>(
    metadataKey: K,
    metadataValue: V
) => CustomDecorator<K>;

Decorator that assigns metadata to the class/function using the specified key.
Requires two parameters: - key - a value defining the key under which the metadata is stored - value - metadata to be associated with key
This metadata can be reflected using the Reflector class.
Example: @SetMetadata('roles', ['admin'])
See Also
- [Reflection](https://docs.nestjs.com/fundamentals/execution-context#reflection-and-metadata)

function Sse

Sse: (path?: string) => MethodDecorator;

Declares this route as a Server-Sent-Events endpoint

function UploadedFile

UploadedFile: {
    (): ParameterDecorator;
    (
        ...pipes: (PipeTransform<any, any> | Type<PipeTransform<any, any>>)[]
    ): ParameterDecorator;
    (
        fileKey?: string,
        ...pipes: (PipeTransform<any, any> | Type<PipeTransform<any, any>>)[]
    ): ParameterDecorator;
};

Route handler parameter decorator. Extracts the file object and populates the decorated parameter with the value of file. Used in conjunction with [multer middleware](https://github.com/expressjs/multer) for Express-based applications.
For example:
uploadFile(@UploadedFile() file) { console.log(file); }
See Also
- [Request object](https://docs.nestjs.com/techniques/file-upload)

function UploadedFiles

UploadedFiles: {
    (): ParameterDecorator;
    (
        ...pipes: (PipeTransform<any, any> | Type<PipeTransform<any, any>>)[]
    ): ParameterDecorator;
};

Route handler parameter decorator. Extracts the files object and populates the decorated parameter with the value of files. Used in conjunction with [multer middleware](https://github.com/expressjs/multer) for Express-based applications.
For example:
uploadFile(@UploadedFiles() files) { console.log(files); }
See Also
- [Request object](https://docs.nestjs.com/techniques/file-upload)

function UseFilters

UseFilters: (
    ...filters: (ExceptionFilter | Function)[]
) => MethodDecorator & ClassDecorator;

Decorator that binds exception filters to the scope of the controller or method, depending on its context.
When @UseFilters is used at the controller level, the filter will be applied to every handler (method) in the controller.
When @UseFilters is used at the individual handler level, the filter will apply only to that specific method.
Parameter filters
exception filter instance or class, or a list of exception filter instances or classes.
See Also
- [Exception filters](https://docs.nestjs.com/exception-filters)
  Exception filters can also be set up globally for all controllers and routes using app.useGlobalFilters(). [See here for details](https://docs.nestjs.com/exception-filters#binding-filters)

function UseGuards

UseGuards: (
    ...guards: (CanActivate | Function)[]
) => MethodDecorator & ClassDecorator;

Decorator that binds guards to the scope of the controller or method, depending on its context.
When @UseGuards is used at the controller level, the guard will be applied to every handler (method) in the controller.
When @UseGuards is used at the individual handler level, the guard will apply only to that specific method.
Parameter guards
a single guard instance or class, or a list of guard instances or classes.
See Also
- [Guards](https://docs.nestjs.com/guards)
  Guards can also be set up globally for all controllers and routes using app.useGlobalGuards(). [See here for details](https://docs.nestjs.com/guards#binding-guards)

function UseInterceptors

UseInterceptors: (
    ...interceptors: (NestInterceptor | Function)[]
) => MethodDecorator & ClassDecorator;

Decorator that binds interceptors to the scope of the controller or method, depending on its context.
When @UseInterceptors is used at the controller level, the interceptor will be applied to every handler (method) in the controller.
When @UseInterceptors is used at the individual handler level, the interceptor will apply only to that specific method.
Parameter interceptors
a single interceptor instance or class, or a list of interceptor instances or classes.
See Also
- [Interceptors](https://docs.nestjs.com/interceptors)
  Interceptors can also be set up globally for all controllers and routes using app.useGlobalInterceptors(). [See here for details](https://docs.nestjs.com/interceptors#binding-interceptors)

function UsePipes

UsePipes: (
    ...pipes: (PipeTransform | Function)[]
) => ClassDecorator & MethodDecorator;

Decorator that binds pipes to the scope of the controller or method, depending on its context.
When @UsePipes is used at the controller level, the pipe will be applied to every handler (method) in the controller.
When @UsePipes is used at the individual handler level, the pipe will apply only to that specific method.
Parameter pipes
a single pipe instance or class, or a list of pipe instances or classes.
See Also
- [Pipes](https://docs.nestjs.com/pipes)
  Pipes can also be set up globally for all controllers and routes using app.useGlobalPipes(). [See here for details](https://docs.nestjs.com/pipes#class-validator)

function Version

Version: (version: VersionValue) => MethodDecorator;

Sets the version of the endpoint to the passed version

Classes

class BadGatewayException

class BadGatewayException extends HttpException {}

Defines an HTTP exception for *Bad Gateway* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a BadGatewayException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new BadGatewayException()
The HTTP response status code will be 502. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 502. - message: the string 'Bad Gateway' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class BadRequestException

class BadRequestException extends HttpException {}

Defines an HTTP exception for *Bad Request* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a BadRequestException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new BadRequestException()
The HTTP response status code will be 400. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 400. - message: the string 'Bad Request' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class ClassSerializerInterceptor

class ClassSerializerInterceptor implements NestInterceptor {}

constructor

constructor(reflector: any, defaultOptions?: ClassSerializerInterceptorOptions);

property defaultOptions

protected readonly defaultOptions: ClassSerializerInterceptorOptions;

property reflector

protected readonly reflector: any;

method getContextOptions

protected getContextOptions: (
    context: ExecutionContext
) => ClassSerializerContextOptions | undefined;

method intercept

intercept: (context: ExecutionContext, next: CallHandler) => Observable<any>;

method serialize

serialize: (
    response: PlainLiteralObject | Array<PlainLiteralObject>,
    options: ClassSerializerContextOptions
) => PlainLiteralObject | Array<PlainLiteralObject>;

Serializes responses that are non-null objects nor streamable files.

method transformToPlain

transformToPlain: (
    plainOrClass: any,
    options: ClassSerializerContextOptions
) => PlainLiteralObject;

class ConfigurableModuleBuilder

class ConfigurableModuleBuilder<
    ModuleOptions,
    StaticMethodKey extends string = typeof DEFAULT_METHOD_KEY,
    FactoryClassMethodKey extends string = typeof DEFAULT_FACTORY_CLASS_METHOD_KEY,
    ExtraModuleDefinitionOptions = {}
> {}

Factory that lets you create configurable modules and provides a way to reduce the majority of dynamic module boilerplate.

constructor

constructor(
    options?: ConfigurableModuleBuilderOptions,
    parentBuilder?: ConfigurableModuleBuilder<
        ModuleOptions,
        'register',
        'create',
        {}
    >
);

property extras

protected extras: {};

property factoryClassMethodKey

protected factoryClassMethodKey: string;

property logger

protected readonly logger: Logger;

property options

protected readonly options: ConfigurableModuleBuilderOptions;

property staticMethodKey

protected staticMethodKey: string;

property transformModuleDefinition

protected transformModuleDefinition: (
    definition: DynamicModule,
    extraOptions: ExtraModuleDefinitionOptions
) => DynamicModule;

method build

build: () => ConfigurableModuleHost<
    ModuleOptions,
    StaticMethodKey,
    FactoryClassMethodKey,
    ExtraModuleDefinitionOptions
>;

Returns an object consisting of multiple properties that lets you easily construct dynamic configurable modules. See "ConfigurableModuleHost" interface for more details.

method setClassMethodName

setClassMethodName: <StaticMethodKey extends string>(
    key: StaticMethodKey
) => ConfigurableModuleBuilder<
    ModuleOptions,
    StaticMethodKey,
    FactoryClassMethodKey,
    ExtraModuleDefinitionOptions
>;

Dynamic modules must expose public static methods that let you pass in configuration parameters (control the module's behavior from the outside). Some frequently used names that you may have seen in other modules are: "forRoot", "forFeature", "register", "configure".
This method "setClassMethodName" lets you specify the name of the method that will be auto-generated.
Parameter key
name of the method

method setExtras

setExtras: <ExtraModuleDefinitionOptions>(
    extras: ExtraModuleDefinitionOptions,
    transformDefinition?: (
        definition: DynamicModule,
        extras: ExtraModuleDefinitionOptions
    ) => DynamicModule
) => ConfigurableModuleBuilder<
    ModuleOptions,
    StaticMethodKey,
    FactoryClassMethodKey,
    ExtraModuleDefinitionOptions
>;

Registers the "extras" object (a set of extra options that can be used to modify the dynamic module definition). Values you specify within the "extras" object will be used as default values (that can be overridden by module consumers).
This method also applies the so-called "module definition transform function" that takes the auto-generated dynamic module object ("DynamicModule") and the actual consumer "extras" object as input parameters. The "extras" object consists of values explicitly specified by module consumers and default values.
Example 1
.setExtras<{ isGlobal?: boolean }>({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }) )

method setFactoryMethodName

setFactoryMethodName: <FactoryClassMethodKey extends string>(
    key: FactoryClassMethodKey
) => ConfigurableModuleBuilder<
    ModuleOptions,
    StaticMethodKey,
    FactoryClassMethodKey,
    ExtraModuleDefinitionOptions
>;

Asynchronously configured modules (that rely on other modules, i.e. "ConfigModule") let you pass the configuration factory class that will be registered and instantiated as a provider. This provider then will be used to retrieve the module's configuration. To provide the configuration, the corresponding factory method must be implemented.
This method ("setFactoryMethodName") lets you control what method name will have to be implemented by the config factory (default is "create").
Parameter key
name of the method

class ConflictException

class ConflictException extends HttpException {}

Defines an HTTP exception for *Conflict* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a ConflictException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new ConflictException()
The HTTP response status code will be 409. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 409. - message: the string 'Conflict' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class ConsoleLogger

class ConsoleLogger implements LoggerService {}

constructor

constructor();

constructor

constructor(context: string);

constructor

constructor(context: string, options: ConsoleLoggerOptions);

property context

protected context?: string;

property options

protected options: ConsoleLoggerOptions;

method colorize

protected colorize: (message: string, logLevel: LogLevel) => string;

method debug

debug: {
    (message: any, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write a 'debug' level log, if the configured level allows for it. Prints to stdout with newline.

method error

error: {
    (message: any, stackOrContext?: string): void;
    (message: any, stack?: string, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write an 'error' level log, if the configured level allows for it. Prints to stderr with newline.

method fatal

fatal: {
    (message: any, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write a 'fatal' level log, if the configured level allows for it. Prints to stdout with newline.

method formatContext

protected formatContext: (context: string) => string;

method formatMessage

protected formatMessage: (
    logLevel: LogLevel,
    message: unknown,
    pidMessage: string,
    formattedLogLevel: string,
    contextMessage: string,
    timestampDiff: string
) => string;

method formatPid

protected formatPid: (pid: number) => string;

method formatTimestampDiff

protected formatTimestampDiff: (timestampDiff: number) => string;

method getTimestamp

protected getTimestamp: () => string;

method isLevelEnabled

isLevelEnabled: (level: LogLevel) => boolean;

method log

log: {
    (message: any, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write a 'log' level log, if the configured level allows for it. Prints to stdout with newline.

method printMessages

protected printMessages: (
    messages: unknown[],
    context?: string,
    logLevel?: LogLevel,
    writeStreamType?: 'stdout' | 'stderr'
) => void;

method printStackTrace

protected printStackTrace: (stack: string) => void;

method resetContext

resetContext: () => void;

Resets the logger context to the value that was passed in the constructor.

method setContext

setContext: (context: string) => void;

Set logger context
Parameter context
context

method setLogLevels

setLogLevels: (levels: LogLevel[]) => void;

Set log levels
Parameter levels
log levels

method stringifyMessage

protected stringifyMessage: (message: unknown, logLevel: LogLevel) => any;

method updateAndGetTimestampDiff

protected updateAndGetTimestampDiff: () => string;

method verbose

verbose: {
    (message: any, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write a 'verbose' level log, if the configured level allows for it. Prints to stdout with newline.

method warn

warn: {
    (message: any, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write a 'warn' level log, if the configured level allows for it. Prints to stdout with newline.

class DefaultValuePipe

class DefaultValuePipe<T = any, R = any> implements PipeTransform<T, T | R> {}

Defines the built-in DefaultValue Pipe
See Also
- [Built-in Pipes](https://docs.nestjs.com/pipes#built-in-pipes)

constructor

constructor(defaultValue: {});

property defaultValue

protected readonly defaultValue: {};

method transform

transform: (value?: T, _metadata?: ArgumentMetadata) => T | R;

class FileTypeValidator

class FileTypeValidator extends FileValidator<FileTypeValidatorOptions, IFile> {}

Defines the built-in FileType File Validator. It validates incoming files mime-type matching a string or a regular expression. Note that this validator uses a naive strategy to check the mime-type and could be fooled if the client provided a file with renamed extension. (for instance, renaming a 'malicious.bat' to 'malicious.jpeg'). To handle such security issues with more reliability, consider checking against the file's [magic-numbers](https://en.wikipedia.org/wiki/Magic_number_%28programming%29)
See Also
- [File Validators](https://docs.nestjs.com/techniques/file-upload#validators)

method buildErrorMessage

buildErrorMessage: () => string;

method isValid

isValid: (file?: IFile) => boolean;

class FileValidator

abstract class FileValidator<
    TValidationOptions = Record<string, any>,
    TFile extends IFile = IFile
> {}

Interface describing FileValidators, which can be added to a ParseFilePipe
See Also
- {ParseFilePipe}

constructor

constructor(validationOptions: {});

property validationOptions

protected readonly validationOptions: {};

method buildErrorMessage

abstract buildErrorMessage: (file: any) => string;

Builds an error message in case the validation fails.
Parameter file
the file from the request object

method isValid

abstract isValid: (
    file?: TFile | TFile[] | Record<string, TFile[]>
) => boolean | Promise<boolean>;

Indicates if this file should be considered valid, according to the options passed in the constructor.
Parameter file
the file from the request object

class ForbiddenException

class ForbiddenException extends HttpException {}

Defines an HTTP exception for *Forbidden* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a ForbiddenException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new ForbiddenException()
The HTTP response status code will be 403. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 403. - message: the string 'Forbidden' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class GatewayTimeoutException

class GatewayTimeoutException extends HttpException {}

Defines an HTTP exception for *Gateway Timeout* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a GatewayTimeoutException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new GatewayTimeoutException()
The HTTP response status code will be 504. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 504. - message: the string 'Gateway Timeout' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class GoneException

class GoneException extends HttpException {}

Defines an HTTP exception for *Gone* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a GoneException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new GoneException()
The HTTP response status code will be 410. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 410. - message: the string 'Gone' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class HttpException

class HttpException extends Error {}

Defines the base Nest HTTP exception, which is handled by the default Exceptions Handler.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    response: string | Record<string, any>,
    status: number,
    options?: HttpExceptionOptions
);

Instantiate a plain HTTP Exception.
Parameter response
string, object describing the error condition or the error cause.
Parameter status
HTTP response status code.
Parameter options
An object used to add an error cause.
Example 1
throw new HttpException('message', HttpStatus.BAD_REQUEST) throw new HttpException('custom message', HttpStatus.BAD_REQUEST, { cause: new Error('Cause Error'), })
The constructor arguments define the response and the HTTP response status code. - The response argument (required) defines the JSON response body. alternatively, it can also be an error object that is used to define an error [cause](https://nodejs.org/en/blog/release/v16.9.0/#error-cause). - The status argument (required) defines the HTTP Status Code. - The options argument (optional) defines additional error options. Currently, it supports the cause attribute, and can be used as an alternative way to specify the error cause: const error = new HttpException('description', 400, { cause: new Error() });
By default, the JSON response body contains two properties: - statusCode: the Http Status Code. - message: a short description of the HTTP error by default; override this by supplying a string in the response parameter.
To override the entire JSON response body, pass an object to the createBody method. Nest will serialize the object and return it as the JSON response body.
The status argument is required, and should be a valid HTTP status code. Best practice is to use the HttpStatus enum imported from nestjs/common.

property cause

cause: {};

method createBody

static createBody: {
    (
        nil: null | '',
        message: HttpExceptionBodyMessage,
        statusCode: number
    ): HttpExceptionBody;
    (
        message: HttpExceptionBodyMessage,
        error: string,
        statusCode: number
    ): HttpExceptionBody;
    <Body extends Record<string, unknown>>(custom: Body): Body;
};

method extractDescriptionAndOptionsFrom

static extractDescriptionAndOptionsFrom: (
    descriptionOrOptions: string | HttpExceptionOptions
) => DescriptionAndOptions;

Utility method used to extract the error description and httpExceptionOptions from the given argument. This is used by inheriting classes to correctly parse both options.
Returns
the error description and the httpExceptionOptions as an object.

method getDescriptionFrom

static getDescriptionFrom: (
    descriptionOrOptions: string | HttpExceptionOptions
) => string;

method getHttpExceptionOptionsFrom

static getHttpExceptionOptionsFrom: (
    descriptionOrOptions: string | HttpExceptionOptions
) => HttpExceptionOptions;

method getResponse

getResponse: () => string | object;

method getStatus

getStatus: () => number;

method initCause

initCause: () => void;

Configures error chaining support
See Also
- https://nodejs.org/en/blog/release/v16.9.0/#error-cause
- https://github.com/microsoft/TypeScript/issues/45167

method initMessage

initMessage: () => void;

method initName

initName: () => void;

class HttpVersionNotSupportedException

class HttpVersionNotSupportedException extends HttpException {}

Defines an HTTP exception for *Http Version Not Supported* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a HttpVersionNotSupportedException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new HttpVersionNotSupportedException()
The HTTP response status code will be 505. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 505. - message: the string 'HTTP Version Not Supported' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class ImATeapotException

class ImATeapotException extends HttpException {}

Defines an HTTP exception for *ImATeapotException* type errors.
Any attempt to brew coffee with a teapot should result in the error code "418 I'm a teapot". The resulting entity body MAY be short and stout.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate an ImATeapotException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new ImATeapotException()
The HTTP response status code will be 418. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 418. - message: the string "I'm a Teapot" by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class InternalServerErrorException

class InternalServerErrorException extends HttpException {}

Defines an HTTP exception for *Internal Server Error* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate an InternalServerErrorException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new InternalServerErrorException()
The HTTP response status code will be 500. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 500. - message: the string 'Internal Server Error' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class Logger

class Logger implements LoggerService {}

constructor

constructor();

constructor

constructor(context: string);

constructor

constructor(context: string, options?: { timestamp?: boolean });

property context

protected context?: string;

property localInstance

readonly localInstance: LoggerService;

property localInstanceRef

protected localInstanceRef?: LoggerService;

property logBuffer

protected static logBuffer: LogBufferRecord[];

property logLevels

protected static logLevels?: LogLevel[];

property options

protected options: { timestamp?: boolean };

property staticInstanceRef

protected static staticInstanceRef?: LoggerService;

method attachBuffer

static attachBuffer: () => void;

Attach buffer. Turns on initialization logs buffering.

method debug

static debug: {
    (message: any, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write a 'debug' level log.
Write a 'debug' level log, if the configured level allows for it. Prints to stdout with newline.

method detachBuffer

static detachBuffer: () => void;

Detach buffer. Turns off initialization logs buffering.

method error

static error: {
    (message: any, stackOrContext?: string): void;
    (message: any, context?: string): void;
    (message: any, stack?: string, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write an 'error' level log.

method fatal

static fatal: {
    (message: any, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write a 'fatal' level log.

method flush

static flush: () => void;

Print buffered logs and detach buffer.

method getTimestamp

static getTimestamp: () => string;

method isLevelEnabled

static isLevelEnabled: (level: LogLevel) => boolean;

method log

static log: {
    (message: any, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write a 'log' level log.

method overrideLogger

static overrideLogger: (logger: LoggerService | LogLevel[] | boolean) => any;

method verbose

static verbose: {
    (message: any, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write a 'verbose' level log.

method warn

static warn: {
    (message: any, context?: string): void;
    (message: any, ...optionalParams: any[]): void;
};

Write a 'warn' level log.

class MaxFileSizeValidator

class MaxFileSizeValidator extends FileValidator<
    MaxFileSizeValidatorOptions,
    IFile
> {}

Defines the built-in MaxSize File Validator
See Also
- [File Validators](https://docs.nestjs.com/techniques/file-upload#file-validation)

method buildErrorMessage

buildErrorMessage: () => string;

method isValid

isValid: (file?: IFile) => boolean;

class MethodNotAllowedException

class MethodNotAllowedException extends HttpException {}

Defines an HTTP exception for *Method Not Allowed* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a MethodNotAllowedException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new MethodNotAllowedException()
The HTTP response status code will be 405. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 405. - message: the string 'Method Not Allowed' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class MisdirectedException

class MisdirectedException extends HttpException {}

Defines an HTTP exception for *Misdirected* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a MisdirectedException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new MisdirectedException()
The HTTP response status code will be 421. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 421. - message: the string 'Bad Gateway' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class NotAcceptableException

class NotAcceptableException extends HttpException {}

Defines an HTTP exception for *Not Acceptable* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a NotAcceptableException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new NotAcceptableException()
The HTTP response status code will be 406. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 406. - error: the string 'Not Acceptable' by default; override this by supplying a string in the error parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class NotFoundException

class NotFoundException extends HttpException {}

Defines an HTTP exception for *Not Found* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a NotFoundException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new NotFoundException()
The HTTP response status code will be 404. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 404. - message: the string 'Not Found' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class NotImplementedException

class NotImplementedException extends HttpException {}

Defines an HTTP exception for *Not Implemented* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a NotImplementedException Exception.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Parameter error
a short description of the HTTP error.
Example 1
throw new NotImplementedException()
The HTTP response status code will be 501. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 501. - message: the string 'Not Implemented' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class ParseArrayPipe

class ParseArrayPipe implements PipeTransform {}

Defines the built-in ParseArray Pipe
See Also
- [Built-in Pipes](https://docs.nestjs.com/pipes#built-in-pipes)

constructor

constructor(options?: ParseArrayOptions);

property exceptionFactory

protected exceptionFactory: (error: string) => any;

property options

protected readonly options: ParseArrayOptions;

property validationPipe

protected readonly validationPipe: ValidationPipe;

method isExpectedTypePrimitive

protected isExpectedTypePrimitive: () => boolean;

method transform

transform: (value: any, metadata: ArgumentMetadata) => Promise<any>;

Method that accesses and performs optional transformation on argument for in-flight requests.
Parameter value
currently processed route argument
Parameter metadata
contains metadata about the currently processed route argument

method validatePrimitive

protected validatePrimitive: (originalValue: any, index?: number) => any;

class ParseBoolPipe

class ParseBoolPipe implements PipeTransform<string | boolean, Promise<boolean>> {}

Defines the built-in ParseBool Pipe
See Also
- [Built-in Pipes](https://docs.nestjs.com/pipes#built-in-pipes)

constructor

constructor(options?: ParseBoolPipeOptions);

property exceptionFactory

protected exceptionFactory: (error: string) => any;

property options

protected readonly options?: ParseBoolPipeOptions;

method isFalse

protected isFalse: (value: string | boolean) => boolean;

Parameter value
currently processed route argument
Returns
true if value is said 'false', ie., if it is equal to the boolean false or the string "false"

method isTrue

protected isTrue: (value: string | boolean) => boolean;

Parameter value
currently processed route argument
Returns
true if value is said 'true', ie., if it is equal to the boolean true or the string "true"

method transform

transform: (
    value: string | boolean,
    metadata: ArgumentMetadata
) => Promise<boolean>;

Method that accesses and performs optional transformation on argument for in-flight requests.
Parameter value
currently processed route argument
Parameter metadata
contains metadata about the currently processed route argument

class ParseEnumPipe

class ParseEnumPipe<T = any> implements PipeTransform<T> {}

Defines the built-in ParseEnum Pipe
See Also
- [Built-in Pipes](https://docs.nestjs.com/pipes#built-in-pipes)

constructor

constructor(enumType: {}, options?: ParseEnumPipeOptions);

property enumType

protected readonly enumType: {};

property exceptionFactory

protected exceptionFactory: (error: string) => any;

property options

protected readonly options?: ParseEnumPipeOptions;

method isEnum

protected isEnum: (value: T) => boolean;

method transform

transform: (value: T, metadata: ArgumentMetadata) => Promise<T>;

Method that accesses and performs optional transformation on argument for in-flight requests.
Parameter value
currently processed route argument
Parameter metadata
contains metadata about the currently processed route argument

class ParseFilePipe

class ParseFilePipe implements PipeTransform<any> {}

Defines the built-in ParseFile Pipe. This pipe can be used to validate incoming files with @UploadedFile() decorator. You can use either other specific built-in validators or provide one of your own, simply implementing it through FileValidator interface and adding it to ParseFilePipe's constructor.
See Also
- [Built-in Pipes](https://docs.nestjs.com/pipes#built-in-pipes)

constructor

constructor(options?: ParseFileOptions);

property exceptionFactory

protected exceptionFactory: (error: string) => any;

method getValidators

getValidators: () => FileValidator<
    Record<string, any>,
    import('./interfaces').IFile
>[];

Returns
list of validators used in this pipe.

method transform

transform: (value: any) => Promise<any>;

method validate

protected validate: (file: any) => Promise<any>;

class ParseFilePipeBuilder

class ParseFilePipeBuilder {}

method addFileTypeValidator

addFileTypeValidator: (options: FileTypeValidatorOptions) => this;

method addMaxSizeValidator

addMaxSizeValidator: (options: MaxFileSizeValidatorOptions) => this;

method addValidator

addValidator: (validator: FileValidator) => this;

method build

build: (
    additionalOptions?: Omit<ParseFileOptions, 'validators'>
) => ParseFilePipe;

class ParseFloatPipe

class ParseFloatPipe implements PipeTransform<string> {}

Defines the built-in ParseFloat Pipe
See Also
- [Built-in Pipes](https://docs.nestjs.com/pipes#built-in-pipes)

constructor

constructor(options?: ParseFloatPipeOptions);

property exceptionFactory

protected exceptionFactory: (error: string) => any;

property options

protected readonly options?: ParseFloatPipeOptions;

method isNumeric

protected isNumeric: (value: string) => boolean;

Parameter value
currently processed route argument
Returns
true if value is a valid float number

method transform

transform: (value: string, metadata: ArgumentMetadata) => Promise<number>;

Method that accesses and performs optional transformation on argument for in-flight requests.
Parameter value
currently processed route argument
Parameter metadata
contains metadata about the currently processed route argument

class ParseIntPipe

class ParseIntPipe implements PipeTransform<string> {}

Defines the built-in ParseInt Pipe
See Also
- [Built-in Pipes](https://docs.nestjs.com/pipes#built-in-pipes)

constructor

constructor(options?: ParseIntPipeOptions);

property exceptionFactory

protected exceptionFactory: (error: string) => any;

property options

protected readonly options?: ParseIntPipeOptions;

method isNumeric

protected isNumeric: (value: string) => boolean;

Parameter value
currently processed route argument
Returns
true if value is a valid integer number

method transform

transform: (value: string, metadata: ArgumentMetadata) => Promise<number>;

Method that accesses and performs optional transformation on argument for in-flight requests.
Parameter value
currently processed route argument
Parameter metadata
contains metadata about the currently processed route argument

class ParseUUIDPipe

class ParseUUIDPipe implements PipeTransform<string> {}

Defines the built-in ParseUUID Pipe
See Also
- [Built-in Pipes](https://docs.nestjs.com/pipes#built-in-pipes)

constructor

constructor(options?: ParseUUIDPipeOptions);

property exceptionFactory

protected exceptionFactory: (errors: string) => any;

property options

protected readonly options?: ParseUUIDPipeOptions;

property uuidRegExps

protected static uuidRegExps: {
    3: RegExp;
    4: RegExp;
    5: RegExp;
    7: RegExp;
    all: RegExp;
};

method isUUID

protected isUUID: (str: unknown, version?: string) => any;

method transform

transform: (value: string, metadata: ArgumentMetadata) => Promise<string>;

class PayloadTooLargeException

class PayloadTooLargeException extends HttpException {}

Defines an HTTP exception for *Payload Too Large* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a PayloadTooLargeException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new PayloadTooLargeException()
The HTTP response status code will be 413. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 413. - message: the string 'Payload Too Large' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class PreconditionFailedException

class PreconditionFailedException extends HttpException {}

Defines an HTTP exception for *Precondition Failed* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a PreconditionFailedException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new PreconditionFailedException()
The HTTP response status code will be 412. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 412. - message: the string 'Precondition Failed' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class RequestTimeoutException

class RequestTimeoutException extends HttpException {}

Defines an HTTP exception for *Request Timeout* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a RequestTimeoutException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new RequestTimeoutException()
The HTTP response status code will be 408. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 408. - message: the string 'Request Timeout' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class ServiceUnavailableException

class ServiceUnavailableException extends HttpException {}

Defines an HTTP exception for *Service Unavailable* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate a ServiceUnavailableException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new ServiceUnavailableException()
The HTTP response status code will be 503. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 503. - message: the string 'Service Unavailable' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class StreamableFile

class StreamableFile {}

See Also
- [Streaming files](https://docs.nestjs.com/techniques/streaming-files)

constructor

constructor(buffer: Uint8Array, options?: StreamableFileOptions);

constructor

constructor(readable: Readable, options?: StreamableFileOptions);

property errorHandler

readonly errorHandler: (err: Error, response: StreamableHandlerResponse) => void;

property errorLogger

readonly errorLogger: (err: Error) => void;

property handleError

protected handleError: (err: Error, response: StreamableHandlerResponse) => void;

property logError

protected logError: (err: Error) => void;

property logger

protected logger: Logger;

property options

readonly options: StreamableFileOptions;

method getHeaders

getHeaders: () => { type: string; disposition: string; length: number };

method getStream

getStream: () => Readable;

method setErrorHandler

setErrorHandler: (
    handler: (err: Error, response: StreamableHandlerResponse) => void
) => this;

method setErrorLogger

setErrorLogger: (handler: (err: Error) => void) => this;

class UnauthorizedException

class UnauthorizedException extends HttpException {}

Defines an HTTP exception for *Unauthorized* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate an UnauthorizedException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new UnauthorizedException()
The HTTP response status code will be 401. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 401. - message: the string 'Unauthorized' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class UnprocessableEntityException

class UnprocessableEntityException extends HttpException {}

Defines an HTTP exception for *Unprocessable Entity* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate an UnprocessableEntityException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new UnprocessableEntityException()
The HTTP response status code will be 422. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 422. - message: the string 'Unprocessable Entity' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class UnsupportedMediaTypeException

class UnsupportedMediaTypeException extends HttpException {}

Defines an HTTP exception for *Unsupported Media Type* type errors.
See Also
- [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)

constructor

constructor(
    objectOrError?: any,
    descriptionOrOptions?: string | HttpExceptionOptions
);

Instantiate an UnsupportedMediaTypeException Exception.
Parameter objectOrError
string or object describing the error condition.
Parameter descriptionOrOptions
either a short description of the HTTP error or an options object used to provide an underlying error cause
Example 1
throw new UnsupportedMediaTypeException()
The HTTP response status code will be 415. - The objectOrError argument defines the JSON response body or the message string. - The descriptionOrOptions argument contains either a short description of the HTTP error or an options object used to provide an underlying error cause.
By default, the JSON response body contains two properties: - statusCode: this will be the value 415. - message: the string 'Unsupported Media Type' by default; override this by supplying a string in the objectOrError parameter.
If the parameter objectOrError is a string, the response body will contain an additional property, error, with a short description of the HTTP error. To override the entire JSON response body, pass an object instead. Nest will serialize the object and return it as the JSON response body.

class ValidationPipe

class ValidationPipe implements PipeTransform<any> {}

See Also
- [Validation](https://docs.nestjs.com/techniques/validation)

constructor

constructor(options?: ValidationPipeOptions);

property errorHttpStatusCode

protected errorHttpStatusCode: ErrorHttpStatusCode;

property exceptionFactory

protected exceptionFactory: (errors: ValidationError[]) => any;

property expectedType

protected expectedType: Type<any>;

property isDetailedOutputDisabled

protected isDetailedOutputDisabled?: boolean;

property isTransformEnabled

protected isTransformEnabled: boolean;

property transformOptions

protected transformOptions: ClassTransformOptions;

property validateCustomDecorators

protected validateCustomDecorators: boolean;

property validatorOptions

protected validatorOptions: ValidatorOptions;

method createExceptionFactory

createExceptionFactory: () => (validationErrors?: ValidationError[]) => unknown;

method flattenValidationErrors

protected flattenValidationErrors: (
    validationErrors: ValidationError[]
) => string[];

method isPrimitive

protected isPrimitive: (value: unknown) => boolean;

method loadTransformer

protected loadTransformer: (
    transformerPackage?: TransformerPackage
) => TransformerPackage;

method loadValidator

protected loadValidator: (
    validatorPackage?: ValidatorPackage
) => ValidatorPackage;

method mapChildrenToValidationErrors

protected mapChildrenToValidationErrors: (
    error: ValidationError,
    parentPath?: string
) => ValidationError[];

method prependConstraintsWithParentProp

protected prependConstraintsWithParentProp: (
    parentPath: string,
    error: ValidationError
) => ValidationError;

method stripProtoKeys

protected stripProtoKeys: (value: any) => void;

method toEmptyIfNil

protected toEmptyIfNil: <T = any, R = any>(value: T) => R | {};

method toValidate

protected toValidate: (metadata: ArgumentMetadata) => boolean;

method transform

transform: (value: any, metadata: ArgumentMetadata) => Promise<any>;

method transformPrimitive

protected transformPrimitive: (value: any, metadata: ArgumentMetadata) => any;

method validate

protected validate: (
    object: object,
    validatorOptions?: ValidatorOptions
) => Promise<ValidationError[]> | ValidationError[];

Interfaces

interface Abstract

interface Abstract<T> extends Function {}

property prototype

prototype: T;

interface ArgumentMetadata

interface ArgumentMetadata {}

Interface describing a pipe implementation's transform() method metadata argument.
See Also
- [Pipes](https://docs.nestjs.com/pipes)

property data

readonly data?: string | undefined;

String passed as an argument to the decorator. Example: @Body('userId') would yield userId

property metatype

readonly metatype?: Type<any> | undefined;

Underlying base type (e.g., String) of the parameter, based on the type definition in the route handler.

property type

readonly type: Paramtype;

Indicates whether argument is a body, query, param, or custom parameter

interface ArgumentsHost

interface ArgumentsHost {}

Provides methods for retrieving the arguments being passed to a handler. Allows choosing the appropriate execution context (e.g., Http, RPC, or WebSockets) to retrieve the arguments from.

method getArgByIndex

getArgByIndex: <T = any>(index: number) => T;

Returns a particular argument by index.
Parameter index
index of argument to retrieve

method getArgs

getArgs: <T extends any[] = any[]>() => T;

Returns the array of arguments being passed to the handler.

method getType

getType: <TContext extends string = ContextType>() => TContext;

Returns the current execution context type (string)

method switchToHttp

switchToHttp: () => HttpArgumentsHost;

Switch context to HTTP.
Returns
interface with methods to retrieve HTTP arguments

method switchToRpc

switchToRpc: () => RpcArgumentsHost;

Switch context to RPC.
Returns
interface with methods to retrieve RPC arguments

method switchToWs

switchToWs: () => WsArgumentsHost;

Switch context to WebSockets.
Returns
interface with methods to retrieve WebSockets arguments

interface BeforeApplicationShutdown

interface BeforeApplicationShutdown {}

method beforeApplicationShutdown

beforeApplicationShutdown: (signal?: string) => any;

interface CallHandler

interface CallHandler<T = any> {}

Interface providing access to the response stream.
See Also
- [Interceptors](https://docs.nestjs.com/interceptors)

method handle

handle: () => Observable<T>;

Returns an Observable representing the response stream from the route handler.

interface CanActivate

interface CanActivate {}

Interface defining the canActivate() function that must be implemented by a guard. Return value indicates whether or not the current request is allowed to proceed. Return can be either synchronous (boolean) or asynchronous (Promise or Observable).
See Also
- [Guards](https://docs.nestjs.com/guards)

method canActivate

canActivate: (
    context: ExecutionContext
) => boolean | Promise<boolean> | Observable<boolean>;

Parameter context
Current execution context. Provides access to details about the current request pipeline.
Returns
Value indicating whether or not the current request is allowed to proceed.

interface ClassProvider

interface ClassProvider<T = any> {}

Interface defining a *Class* type provider.
For example:
const configServiceProvider = { provide: ConfigService, useClass: process.env.NODE_ENV === 'development' ? DevelopmentConfigService : ProductionConfigService, };
See Also
- [Class providers](https://docs.nestjs.com/fundamentals/custom-providers#class-providers-useclass)
- [Injection scopes](https://docs.nestjs.com/fundamentals/injection-scopes)

property durable

durable?: boolean;

Flags provider as durable. This flag can be used in combination with custom context id factory strategy to construct lazy DI subtrees.
This flag can be used only in conjunction with scope = Scope.REQUEST.

property inject

inject?: never;

This option is only available on factory providers!
See Also
- [Use factory](https://docs.nestjs.com/fundamentals/custom-providers#factory-providers-usefactory)

property provide

provide: InjectionToken;

Injection token

property scope

scope?: Scope;

Optional enum defining lifetime of the provider that is injected.

property useClass

useClass: Type<T>;

Type (class name) of provider (instance to be injected).

interface ClassSerializerContextOptions

interface ClassSerializerContextOptions extends ClassTransformOptions {}

property type

type?: Type<any>;

interface ClassSerializerInterceptorOptions

interface ClassSerializerInterceptorOptions extends ClassTransformOptions {}

property transformerPackage

transformerPackage?: TransformerPackage;

interface ConfigurableModuleAsyncOptions

interface ConfigurableModuleAsyncOptions<
    ModuleOptions,
    FactoryClassMethodKey extends string = typeof DEFAULT_FACTORY_CLASS_METHOD_KEY
> extends Pick<ModuleMetadata, 'imports'> {}

Interface that represents the module async options object Factory method name varies depending on the "FactoryClassMethodKey" type argument.

property inject

inject?: FactoryProvider['inject'];

Dependencies that a Factory may inject.

property provideInjectionTokensFrom

provideInjectionTokensFrom?: Provider[];

List of parent module's providers that will be filtered to only provide necessary providers for the 'inject' array useful to pass options to nested async modules

property useClass

useClass?: Type<
    ConfigurableModuleOptionsFactory<ModuleOptions, FactoryClassMethodKey>
>;

Injection token resolving to a class that will be instantiated as a provider. The class must implement the corresponding interface.

property useExisting

useExisting?: Type<
    ConfigurableModuleOptionsFactory<ModuleOptions, FactoryClassMethodKey>
>;

Injection token resolving to an existing provider. The provider must implement the corresponding interface.

property useFactory

useFactory?: (...args: any[]) => Promise<ModuleOptions> | ModuleOptions;

Function returning options (or a Promise resolving to options) to configure the cache module.

interface ConfigurableModuleBuilderOptions

interface ConfigurableModuleBuilderOptions {}

property alwaysTransient

alwaysTransient?: boolean;

Indicates whether module should always be "transient" - meaning, every time you call the static method to construct a dynamic module, regardless of what arguments you pass in, a new "unique" module will be created.
false

property moduleName

moduleName?: string;

By default, an UUID will be used as a module options provider token. Explicitly specifying the "moduleName" will instruct the "ConfigurableModuleBuilder" to use a more descriptive provider token.
For example, moduleName: "Cache" will auto-generate the provider token: "CACHE_MODULE_OPTIONS".

property optionsInjectionToken

optionsInjectionToken?: string | symbol;

Specifies what injection token should be used for the module options provider. By default, an auto-generated UUID will be used.

interface ConfigurableModuleHost

interface ConfigurableModuleHost<
    ModuleOptions = Record<string, unknown>,
    MethodKey extends string = string,
    FactoryClassMethodKey extends string = string,
    ExtraModuleDefinitionOptions = {}
> {}

Configurable module host. See properties for more details

property ASYNC_OPTIONS_TYPE

ASYNC_OPTIONS_TYPE: ConfigurableModuleAsyncOptions<
    ModuleOptions,
    FactoryClassMethodKey
> &
    Partial<ExtraModuleDefinitionOptions>;

Can be used to auto-infer the compound "async module options" type. Note: this property is not supposed to be used as a value.

Example 1

@Module({})
class IntegrationModule extends ConfigurableModuleCls {
 static module = initializer(IntegrationModule);

static registerAsync(options: typeof ASYNC_OPTIONS_TYPE): DynamicModule {
 return super.registerAsync(options);
}

property ConfigurableModuleClass

ConfigurableModuleClass: ConfigurableModuleCls<
    ModuleOptions,
    MethodKey,
    FactoryClassMethodKey,
    ExtraModuleDefinitionOptions
>;

Class that represents a blueprint/prototype for a configurable Nest module. This class provides static methods for constructing dynamic modules. Their names can be controlled through the "MethodKey" type argument.
Your module class should inherit from this class to make the static methods available.
Example 1
@Module({}) class IntegrationModule extends ConfigurableModuleCls { // ... }

property MODULE_OPTIONS_TOKEN

MODULE_OPTIONS_TOKEN: string | symbol;

Module options provider token. Can be used to inject the "options object" to providers registered within the host module.

property OPTIONS_TYPE

OPTIONS_TYPE: ModuleOptions & Partial<ExtraModuleDefinitionOptions>;

Can be used to auto-infer the compound "module options" type (options interface + extra module definition options). Note: this property is not supposed to be used as a value.

Example 1

@Module({})
class IntegrationModule extends ConfigurableModuleCls {
 static module = initializer(IntegrationModule);

static register(options: typeof OPTIONS_TYPE): DynamicModule {
 return super.register(options);
}

interface ConsoleLoggerOptions

interface ConsoleLoggerOptions {}

property logLevels

logLevels?: LogLevel[];

Enabled log levels.

property timestamp

timestamp?: boolean;

If enabled, will print timestamp (time difference) between current and previous log message.

interface ControllerOptions

interface ControllerOptions extends ScopeOptions, VersionOptions {}

Interface defining options that can be passed to @Controller() decorator

property host

host?: string | RegExp | Array<string | RegExp>;

Specifies an optional HTTP Request host filter. When configured, methods within the controller will only be routed if the request host matches the specified value.
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)

property path

path?: string | string[];

Specifies an optional route path prefix. The prefix is pre-pended to the path specified in any request decorator in the class.
Supported only by HTTP-based applications (does not apply to non-HTTP microservices).
See Also
- [Routing](https://docs.nestjs.com/controllers#routing)

interface DescriptionAndOptions

interface DescriptionAndOptions {}

property description

description?: string;

property httpExceptionOptions

httpExceptionOptions?: HttpExceptionOptions;

interface DynamicModule

interface DynamicModule extends ModuleMetadata {}

Interface defining a Dynamic Module.
See Also
- [Dynamic Modules](https://docs.nestjs.com/modules#dynamic-modules)

property global

global?: boolean;

When "true", makes a module global-scoped.
Once imported into any module, a global-scoped module will be visible in all modules. Thereafter, modules that wish to inject a service exported from a global module do not need to import the provider module.
false

property module

module: Type<any>;

A module reference

interface ExceptionFilter

interface ExceptionFilter<T = any> {}

Interface describing implementation of an exception filter.
See Also
- [Exception Filters](https://docs.nestjs.com/exception-filters)

method catch

catch: (exception: T, host: ArgumentsHost) => any;

Method to implement a custom exception filter.
Parameter exception
the class of the exception being handled
Parameter host
used to access an array of arguments for the in-flight request

interface ExecutionContext

interface ExecutionContext extends ArgumentsHost {}

Interface describing details about the current request pipeline.
See Also
- [Execution Context](https://docs.nestjs.com/guards#execution-context)

method getClass

getClass: <T = any>() => Type<T>;

Returns the *type* of the controller class which the current handler belongs to.

method getHandler

getHandler: () => Function;

Returns a reference to the handler (method) that will be invoked next in the request pipeline.

interface ExistingProvider

interface ExistingProvider<T = any> {}

Interface defining an *Existing* (aliased) type provider.
For example:
const loggerAliasProvider = { provide: 'AliasedLoggerService', useExisting: LoggerService };
See Also
- [Alias providers](https://docs.nestjs.com/fundamentals/custom-providers#alias-providers-useexisting)

property provide

provide: InjectionToken;

Injection token

property useExisting

useExisting: any;

Provider to be aliased by the Injection token.

interface FactoryProvider

interface FactoryProvider<T = any> {}

Interface defining a *Factory* type provider.

For example:

const connectionFactory = {
  provide: 'CONNECTION',
  useFactory: (optionsProvider: OptionsProvider) => {
    const options = optionsProvider.get();
    return new DatabaseConnection(options);
  },
  inject: [OptionsProvider],
};

property durable

durable?: boolean;

Flags provider as durable. This flag can be used in combination with custom context id factory strategy to construct lazy DI subtrees.
This flag can be used only in conjunction with scope = Scope.REQUEST.

property inject

inject?: Array<InjectionToken | OptionalFactoryDependency>;

Optional list of providers to be injected into the context of the Factory function.

property provide

provide: InjectionToken;

Injection token

property scope

scope?: Scope;

Optional enum defining lifetime of the provider that is returned by the Factory function.

property useFactory

useFactory: (...args: any[]) => T | Promise<T>;

Factory function that returns an instance of the provider to be injected.

interface ForwardReference

interface ForwardReference<T = any> {}

property forwardRef

forwardRef: T;

interface HttpExceptionBody

interface HttpExceptionBody {}

property error

error?: string;

property message

message: HttpExceptionBodyMessage;

property statusCode

statusCode: number;

interface HttpExceptionOptions

interface HttpExceptionOptions {}

property cause

cause?: unknown;

original cause of the error

property description

description?: string;

interface HttpRedirectResponse

interface HttpRedirectResponse {}

property statusCode

statusCode: HttpStatus;

property url

url: string;

interface HttpServer

interface HttpServer<TRequest = any, TResponse = any, ServerInstance = any> {}

method all

all: {
    (path: string, handler: RequestHandler<TRequest, TResponse>): any;
    (handler: RequestHandler<TRequest, TResponse>): any;
};

method applyVersionFilter

applyVersionFilter: (
    handler: Function,
    version: VersionValue,
    versioningOptions: VersioningOptions
) => (req: TRequest, res: TResponse, next: () => void) => Function;

method close

close: () => any;

method createMiddlewareFactory

createMiddlewareFactory: (
    method: RequestMethod
) =>
    | ((path: string, callback: Function) => any)
    | Promise<(path: string, callback: Function) => any>;

method delete

delete: {
    (handler: RequestHandler<TRequest, TResponse>): any;
    (path: string, handler: RequestHandler<TRequest, TResponse>): any;
};

method enableCors

enableCors: (options: CorsOptions | CorsOptionsDelegate<TRequest>) => any;

method end

end: (response: any, message?: string) => any;

method get

get: {
    (handler: RequestHandler<TRequest, TResponse>): any;
    (path: string, handler: RequestHandler<TRequest, TResponse>): any;
};

method getHttpServer

getHttpServer: () => any;

method getInstance

getInstance: () => ServerInstance;

method getRequestHostname

getRequestHostname: (request: TRequest) => string;

method getRequestMethod

getRequestMethod: (request: TRequest) => string;

method getRequestUrl

getRequestUrl: (request: TRequest) => string;

method getType

getType: () => string;

method head

head: {
    (handler: RequestHandler<TRequest, TResponse>): any;
    (path: string, handler: RequestHandler<TRequest, TResponse>): any;
};

method init

init: () => Promise<void>;

method initHttpServer

initHttpServer: (options: NestApplicationOptions) => void;

method isHeadersSent

isHeadersSent: (response: any) => boolean;

method listen

listen: {
    (port: number | string, callback?: () => void): any;
    (port: string | number, hostname: string, callback?: () => void): any;
};

method options

options: {
    (handler: RequestHandler<TRequest, TResponse>): any;
    (path: string, handler: RequestHandler<TRequest, TResponse>): any;
};

method patch

patch: {
    (handler: RequestHandler<TRequest, TResponse>): any;
    (path: string, handler: RequestHandler<TRequest, TResponse>): any;
};

method post

post: {
    (handler: RequestHandler<TRequest, TResponse>): any;
    (path: string, handler: RequestHandler<TRequest, TResponse>): any;
};

method put

put: {
    (handler: RequestHandler<TRequest, TResponse>): any;
    (path: string, handler: RequestHandler<TRequest, TResponse>): any;
};

method redirect

redirect: (response: any, statusCode: number, url: string) => any;

method registerParserMiddleware

registerParserMiddleware: (...args: any[]) => any;

method render

render: (response: any, view: string, options: any) => any;

method reply

reply: (response: any, body: any, statusCode?: number) => any;

method search

search: {
    (handler: RequestHandler<TRequest, TResponse>): any;
    (path: string, handler: RequestHandler<TRequest, TResponse>): any;
};

method setBaseViewsDir

setBaseViewsDir: (path: string | string[]) => this;

method setErrorHandler

setErrorHandler: (handler: Function, prefix?: string) => any;

method setHeader

setHeader: (response: any, name: string, value: string) => any;

method setNotFoundHandler

setNotFoundHandler: (handler: Function, prefix?: string) => any;

method setViewEngine

setViewEngine: (engineOrOptions: any) => this;

method status

status: (response: any, statusCode: number) => any;

method use

use: {
    (
        handler:
            | RequestHandler<TRequest, TResponse>
            | ErrorHandler<TRequest, TResponse>
    ): any;
    (
        path: string,
        handler:
            | RequestHandler<TRequest, TResponse>
            | ErrorHandler<TRequest, TResponse>
    ): any;
};

method useBodyParser

useBodyParser: (...args: any[]) => any;

method useStaticAssets

useStaticAssets: (...args: any[]) => this;

interface INestApplication

interface INestApplication<TServer = any> extends INestApplicationContext {}

Interface defining the core NestApplication object.

method close

close: () => Promise<void>;

Terminates the application (including NestApplication, Gateways, and each connected microservice)
Returns
{Promise}

method connectMicroservice

connectMicroservice: <T extends object = any>(
    options: T,
    hybridOptions?: NestHybridApplicationOptions
) => INestMicroservice;

Connects microservice to the NestApplication instance. Transforms application to a hybrid instance.
{object} T
Parameter options
Microservice options object
Parameter hybridOptions
Hybrid options object
Returns
{INestMicroservice}

method enableCors

enableCors: (options?: CorsOptions | CorsOptionsDelegate<any>) => void;

Enables CORS (Cross-Origin Resource Sharing)
Returns
{void}

method enableVersioning

enableVersioning: (options?: VersioningOptions) => this;

Enables Versioning for the application. By default, URI-based versioning is used.
Parameter options
Returns
{this}

method getHttpAdapter

getHttpAdapter: () => HttpServer;

Returns the underlying HTTP adapter.
Returns
{HttpServer}

method getHttpServer

getHttpServer: () => TServer;

Returns the underlying native HTTP server.
Returns
{TServer}

method getMicroservices

getMicroservices: () => INestMicroservice[];

Returns array of the microservices connected to the NestApplication.
Returns
{INestMicroservice[]}

method getUrl

getUrl: () => Promise<string>;

Returns the url the application is listening at, based on OS and IP version. Returns as an IP value either in IPv6 or IPv4
Returns
{Promise} The IP where the server is listening

method listen

listen: {
    (port: number | string, callback?: () => void): Promise<any>;
    (
        port: string | number,
        hostname: string,
        callback?: () => void
    ): Promise<any>;
};

Starts the application.
Parameter port
Parameter hostname
Parameter callback
Optional callback
Returns
{Promise} A Promise that, when resolved, is a reference to the underlying HttpServer.

method setGlobalPrefix

setGlobalPrefix: (prefix: string, options?: GlobalPrefixOptions) => this;

Registers a prefix for every HTTP route path.
Parameter prefix
The prefix for every HTTP route path (for example /v1/api)
Parameter options
Global prefix options object
Returns
{this}

method startAllMicroservices

startAllMicroservices: () => Promise<this>;

Starts all connected microservices asynchronously.
Returns
{Promise}

method use

use: (...args: any[]) => this;

A wrapper function around HTTP adapter method: adapter.use(). Example app.use(cors())
Returns
{this}

method useGlobalFilters

useGlobalFilters: (...filters: ExceptionFilter[]) => this;

Registers exception filters as global filters (will be used within every HTTP route handler)
Parameter filters

method useGlobalGuards

useGlobalGuards: (...guards: CanActivate[]) => this;

Registers guards as global guards (will be used within every HTTP route handler)
Parameter guards

method useGlobalInterceptors

useGlobalInterceptors: (...interceptors: NestInterceptor[]) => this;

Registers interceptors as global interceptors (will be used within every HTTP route handler)
Parameter interceptors

method useGlobalPipes

useGlobalPipes: (...pipes: PipeTransform<any>[]) => this;

Registers pipes as global pipes (will be used within every HTTP route handler)
Parameter pipes

method useWebSocketAdapter

useWebSocketAdapter: (adapter: WebSocketAdapter) => this;

Register Ws Adapter which will be used inside Gateways. Use when you want to override default socket.io library.
Parameter adapter
Returns
{this}

interface INestApplicationContext

interface INestApplicationContext {}

Interface defining NestApplicationContext.

method close

close: () => Promise<void>;

Terminates the application
Returns
{Promise}

method enableShutdownHooks

enableShutdownHooks: (signals?: ShutdownSignal[] | string[]) => this;

Enables the usage of shutdown hooks. Will call the onApplicationShutdown function of a provider if the process receives a shutdown signal.
Returns
{this} The Nest application context instance

method flushLogs

flushLogs: () => void;

Prints buffered logs and detaches buffer.
Returns
{void}

method get

get: {
    <TInput = any, TResult = TInput>(
        typeOrToken: Type<TInput> | Function | string | symbol
    ): TResult;
    <TInput = any, TResult = TInput>(
        typeOrToken: string | symbol | Function | Type<TInput>,
        options: { strict?: boolean; each?: false }
    ): TResult;
    <TInput = any, TResult = TInput>(
        typeOrToken: string | symbol | Function | Type<TInput>,
        options: { strict?: boolean; each: true }
    ): TResult[];
    <TInput = any, TResult = TInput>(
        typeOrToken: string | symbol | Function | Type<TInput>,
        options?: GetOrResolveOptions
    ): TResult | TResult[];
};

Retrieves an instance of either injectable or controller, otherwise, throws exception.
Returns
{TResult}
Retrieves a list of instances of either injectables or controllers, otherwise, throws exception.
Returns
{Array}
Retrieves an instance (or a list of instances) of either injectable or controller, otherwise, throws exception.
Returns
{TResult | Array}

method init

init: () => Promise<this>;

Initializes the Nest application. Calls the Nest lifecycle events. It isn't mandatory to call this method directly.
Returns
{Promise} The NestApplicationContext instance as Promise

method registerRequestByContextId

registerRequestByContextId: <T = any>(
    request: T,
    contextId: { id: number }
) => void;

Registers the request/context object for a given context ID (DI container sub-tree).
Returns
{void}

method resolve

resolve: {
    <TInput = any, TResult = TInput>(
        typeOrToken: Type<TInput> | Function | string | symbol
    ): Promise<TResult>;
    <TInput = any, TResult = TInput>(
        typeOrToken: string | symbol | Function | Type<TInput>,
        contextId?: { id: number }
    ): Promise<TResult>;
    <TInput = any, TResult = TInput>(
        typeOrToken: string | symbol | Function | Type<TInput>,
        contextId?: { id: number },
        options?: { strict?: boolean; each?: false }
    ): Promise<TResult>;
    <TInput = any, TResult = TInput>(
        typeOrToken: string | symbol | Function | Type<TInput>,
        contextId?: { id: number },
        options?: { strict?: boolean; each: true }
    ): Promise<TResult[]>;
    <TInput = any, TResult = TInput>(
        typeOrToken: string | symbol | Function | Type<TInput>,
        contextId?: { id: number },
        options?: GetOrResolveOptions
    ): Promise<TResult | TResult[]>;
};

Resolves transient or request-scoped instance of either injectable or controller, otherwise, throws exception.
Returns
{Array}
Resolves transient or request-scoped instances of either injectables or controllers, otherwise, throws exception.
Returns
{Array}
Resolves transient or request-scoped instance (or a list of instances) of either injectable or controller, otherwise, throws exception.
Returns
{Promise<TResult | Array>}

method select

select: <T>(module: Type<T> | DynamicModule) => INestApplicationContext;

Allows navigating through the modules tree, for example, to pull out a specific instance from the selected module.
Returns
{INestApplicationContext}

method useLogger

useLogger: (logger: LoggerService | LogLevel[] | false) => void;

Sets custom logger service. Flushes buffered logs if auto flush is on.
Returns
{void}

interface INestMicroservice

interface INestMicroservice extends INestApplicationContext {}

Interface describing Microservice Context.

method close

close: () => Promise<void>;

Terminates the application
Returns
{Promise}

method listen

listen: () => Promise<any>;

Starts the microservice.
Returns
{void}

method useGlobalFilters

useGlobalFilters: (...filters: ExceptionFilter[]) => this;

Registers exception filters as global filters (will be used within every message pattern handler)
Parameter filters

method useGlobalGuards

useGlobalGuards: (...guards: CanActivate[]) => this;

Registers guards as global guards (will be used within every message pattern handler)
Parameter guards

method useGlobalInterceptors

useGlobalInterceptors: (...interceptors: NestInterceptor[]) => this;

Registers interceptors as global interceptors (will be used within every message pattern handler)
Parameter interceptors

method useGlobalPipes

useGlobalPipes: (...pipes: PipeTransform<any>[]) => this;

Registers pipes as global pipes (will be used within every message pattern handler)
Parameter pipes

method useWebSocketAdapter

useWebSocketAdapter: (adapter: WebSocketAdapter) => this;

Register Ws Adapter which will be used inside Gateways. Use when you want to override default socket.io library.
Parameter adapter
Returns
{this}

interface IntrospectionResult

interface IntrospectionResult {}

property scope

scope: Scope;

Enum defining lifetime of host class or factory.

interface LoggerService

interface LoggerService {}

method debug

debug: (message: any, ...optionalParams: any[]) => any;

Write a 'debug' level log.

method error

error: (message: any, ...optionalParams: any[]) => any;

Write an 'error' level log.

method fatal

fatal: (message: any, ...optionalParams: any[]) => any;

Write a 'fatal' level log.

method log

log: (message: any, ...optionalParams: any[]) => any;

Write a 'log' level log.

method setLogLevels

setLogLevels: (levels: LogLevel[]) => any;

Set log levels.
Parameter levels
log levels

method verbose

verbose: (message: any, ...optionalParams: any[]) => any;

Write a 'verbose' level log.

method warn

warn: (message: any, ...optionalParams: any[]) => any;

Write a 'warn' level log.

interface MessageEvent

interface MessageEvent {}

property data

data: string | object;

property id

id?: string;

property retry

retry?: number;

property type

type?: string;

interface MiddlewareConsumer

interface MiddlewareConsumer {}

Interface defining method for applying user defined middleware to routes.
See Also
- [MiddlewareConsumer](https://docs.nestjs.com/middleware#middleware-consumer)

method apply

apply: (...middleware: (Type<any> | Function)[]) => MiddlewareConfigProxy;

Parameter middleware
middleware class/function or array of classes/functions to be attached to the passed routes.
Returns
{MiddlewareConfigProxy}

interface ModuleMetadata

interface ModuleMetadata {}

Interface defining the property object that describes the module.
See Also
- [Modules](https://docs.nestjs.com/modules)

property controllers

controllers?: Type<any>[];

Optional list of controllers defined in this module which have to be instantiated.

property exports

exports?: Array<
    | DynamicModule
    | Promise<DynamicModule>
    | string
    | symbol
    | Provider
    | ForwardReference
    | Abstract<any>
    | Function
>;

Optional list of the subset of providers that are provided by this module and should be available in other modules which import this module.

property imports

imports?: Array<
    Type<any> | DynamicModule | Promise<DynamicModule> | ForwardReference
>;

Optional list of imported modules that export the providers which are required in this module.

property providers

providers?: Provider[];

Optional list of providers that will be instantiated by the Nest injector and that may be shared at least across this module.

interface NestApplicationOptions

interface NestApplicationOptions extends NestApplicationContextOptions {}

property bodyParser

bodyParser?: boolean;

Whether to use underlying platform body parser.

property cors

cors?: boolean | CorsOptions | CorsOptionsDelegate<any>;

CORS options from [CORS package](https://github.com/expressjs/cors#configuration-options)

property forceCloseConnections

forceCloseConnections?: boolean;

Force close open HTTP connections. Useful if restarting your application hangs due to keep-alive connections in the HTTP adapter.

property httpsOptions

httpsOptions?: HttpsOptions;

Set of configurable HTTPS options

property rawBody

rawBody?: boolean;

Whether to register the raw request body on the request. Use req.rawBody.

interface NestHybridApplicationOptions

interface NestHybridApplicationOptions {}

property inheritAppConfig

inheritAppConfig?: boolean;

interface NestInterceptor

interface NestInterceptor<T = any, R = any> {}

Interface describing implementation of an interceptor.
See Also
- [Interceptors](https://docs.nestjs.com/interceptors)

method intercept

intercept: (
    context: ExecutionContext,
    next: CallHandler<T>
) => Observable<R> | Promise<Observable<R>>;

Method to implement a custom interceptor.
Parameter context
an ExecutionContext object providing methods to access the route handler and class about to be invoked.
Parameter next
a reference to the CallHandler, which provides access to an Observable representing the response stream from the route handler.

interface NestMiddleware

interface NestMiddleware<TRequest = any, TResponse = any> {}

See Also
- [Middleware](https://docs.nestjs.com/middleware)

method use

use: (req: TRequest, res: TResponse, next: (error?: Error | any) => void) => any;

interface NestModule

interface NestModule {}

method configure

configure: (consumer: MiddlewareConsumer) => any;

interface OnApplicationBootstrap

interface OnApplicationBootstrap {}

Interface defining method called once the application has fully started and is bootstrapped.
See Also
- [Lifecycle Events](https://docs.nestjs.com/fundamentals/lifecycle-events)

method onApplicationBootstrap

onApplicationBootstrap: () => any;

interface OnApplicationShutdown

interface OnApplicationShutdown {}

Interface defining method to respond to system signals (when application gets shutdown by, e.g., SIGTERM)
See Also
- [Lifecycle Events](https://docs.nestjs.com/fundamentals/lifecycle-events)

method onApplicationShutdown

onApplicationShutdown: (signal?: string) => any;

interface OnModuleDestroy

interface OnModuleDestroy {}

Interface defining method called just before Nest destroys the host module (app.close() method has been evaluated). Use to perform cleanup on resources (e.g., Database connections).
See Also
- [Lifecycle Events](https://docs.nestjs.com/fundamentals/lifecycle-events)

method onModuleDestroy

onModuleDestroy: () => any;

interface OnModuleInit

interface OnModuleInit {}

Interface defining method called once the host module has been initialized.
See Also
- [Lifecycle Events](https://docs.nestjs.com/fundamentals/lifecycle-events)

method onModuleInit

onModuleInit: () => any;

interface ParseArrayOptions

interface ParseArrayOptions
    extends Omit<
        ValidationPipeOptions,
        'transform' | 'validateCustomDecorators' | 'exceptionFactory'
    > {}

property exceptionFactory

exceptionFactory?: (error: any) => any;

property items

items?: Type<unknown>;

property optional

optional?: boolean;

property separator

separator?: string;

interface ParseBoolPipeOptions

interface ParseBoolPipeOptions {}

property errorHttpStatusCode

errorHttpStatusCode?: ErrorHttpStatusCode;

property exceptionFactory

exceptionFactory?: (error: string) => any;

property optional

optional?: boolean;

interface ParseEnumPipeOptions

interface ParseEnumPipeOptions {}

property errorHttpStatusCode

errorHttpStatusCode?: ErrorHttpStatusCode;

property exceptionFactory

exceptionFactory?: (error: string) => any;

property optional

optional?: boolean;

interface ParseFileOptions

interface ParseFileOptions {}

property errorHttpStatusCode

errorHttpStatusCode?: ErrorHttpStatusCode;

property exceptionFactory

exceptionFactory?: (error: string) => any;

property fileIsRequired

fileIsRequired?: boolean;

Defines if file parameter is required. true

property validators

validators?: FileValidator[];

interface ParseFloatPipeOptions

interface ParseFloatPipeOptions {}

property errorHttpStatusCode

errorHttpStatusCode?: ErrorHttpStatusCode;

property exceptionFactory

exceptionFactory?: (error: string) => any;

property optional

optional?: boolean;

interface ParseIntPipeOptions

interface ParseIntPipeOptions {}

property errorHttpStatusCode

errorHttpStatusCode?: ErrorHttpStatusCode;

property exceptionFactory

exceptionFactory?: (error: string) => any;

property optional

optional?: boolean;

interface ParseUUIDPipeOptions

interface ParseUUIDPipeOptions {}

property errorHttpStatusCode

errorHttpStatusCode?: ErrorHttpStatusCode;

property exceptionFactory

exceptionFactory?: (errors: string) => any;

property optional

optional?: boolean;

property version

version?: '3' | '4' | '5' | '7';

interface PipeTransform

interface PipeTransform<T = any, R = any> {}

Interface describing implementation of a pipe.
See Also
- [Pipes](https://docs.nestjs.com/pipes)

method transform

transform: (value: T, metadata: ArgumentMetadata) => R;

Method to implement a custom pipe. Called with two parameters
Parameter value
argument before it is received by route handler method
Parameter metadata
contains metadata about the value

interface PlainLiteralObject

interface PlainLiteralObject {}

index signature

[key: string]: any;

interface RequestMappingMetadata

interface RequestMappingMetadata {}

property method

method?: RequestMethod;

property path

path?: string | string[];

interface ResponseDecoratorOptions

interface ResponseDecoratorOptions {}

The @Response()/@Res parameter decorator options.

property passthrough

passthrough: boolean;

Determines whether the response will be sent manually within the route handler, with the use of native response handling methods exposed by the platform-specific response object, or if it should passthrough Nest response processing pipeline.
false

interface RouteParamMetadata

interface RouteParamMetadata {}

property data

data?: ParamData;

property index

index: number;

interface RpcExceptionFilter

interface RpcExceptionFilter<T = any, R = any> {}

Interface describing implementation of an RPC exception filter.
See Also
- [Exception Filters](https://docs.nestjs.com/microservices/exception-filters)

method catch

catch: (exception: T, host: ArgumentsHost) => Observable<R>;

Method to implement a custom (microservice) exception filter.
Parameter exception
the type (class) of the exception being handled
Parameter host
used to access an array of arguments for the in-flight message

interface ScopeOptions

interface ScopeOptions {}

See Also
- [Injection Scopes](https://docs.nestjs.com/fundamentals/injection-scopes)

property durable

durable?: boolean;

Flags provider as durable. This flag can be used in combination with custom context id factory strategy to construct lazy DI subtrees.
This flag can be used only in conjunction with scope = Scope.REQUEST.

property scope

scope?: Scope;

Specifies the lifetime of an injected Provider or Controller.

interface Type

interface Type<T = any> extends Function {}

construct signature

new (...args: any[]): T;

interface ValidationError

interface ValidationError {}

Validation error description.
See Also
- https://github.com/typestack/class-validator
  class-validator@0.13.0

property children

children?: ValidationError[];

Contains all nested validation errors of the property.

property constraints

constraints?: {
    [type: string]: string;
};

Constraints that failed validation with error messages.

property contexts

contexts?: {
    [type: string]: any;
};

A transient set of data passed through to the validation result for response mapping

property property

property: string;

Object's property that hasn't passed validation.

property target

target?: Record<string, any>;

Object that was validated.
OPTIONAL - configurable via the ValidatorOptions.validationError.target option

property value

value?: any;

Value that haven't pass a validation.
OPTIONAL - configurable via the ValidatorOptions.validationError.value option

interface ValidationPipeOptions

interface ValidationPipeOptions extends ValidatorOptions {}

property disableErrorMessages

disableErrorMessages?: boolean;

property errorHttpStatusCode

errorHttpStatusCode?: ErrorHttpStatusCode;

property exceptionFactory

exceptionFactory?: (errors: ValidationError[]) => any;

property expectedType

expectedType?: Type<any>;

property transform

transform?: boolean;

property transformerPackage

transformerPackage?: TransformerPackage;

property transformOptions

transformOptions?: ClassTransformOptions;

property validateCustomDecorators

validateCustomDecorators?: boolean;

property validatorPackage

validatorPackage?: ValidatorPackage;

interface ValueProvider

interface ValueProvider<T = any> {}

Interface defining a *Value* type provider.
For example:
const connectionProvider = { provide: 'CONNECTION', useValue: connection, };
See Also
- [Value providers](https://docs.nestjs.com/fundamentals/custom-providers#value-providers-usevalue)

property inject

inject?: never;

This option is only available on factory providers!
See Also
- [Use factory](https://docs.nestjs.com/fundamentals/custom-providers#factory-providers-usefactory)

property provide

provide: InjectionToken;

Injection token

property useValue

useValue: T;

Instance of a provider to be injected.

interface WebSocketAdapter

interface WebSocketAdapter<TServer = any, TClient = any, TOptions = any> {}

method bindClientConnect

bindClientConnect: (server: TServer, callback: Function) => any;

method bindClientDisconnect

bindClientDisconnect: (client: TClient, callback: Function) => any;

method bindMessageHandlers

bindMessageHandlers: (
    client: TClient,
    handlers: WsMessageHandler[],
    transform: (data: any) => Observable<any>
) => any;

method close

close: (server: TServer) => any;

method create

create: (port: number, options?: TOptions) => TServer;

interface WsExceptionFilter

interface WsExceptionFilter<T = any> {}

Interface describing implementation of a Web Sockets exception filter.
See Also
- [Exception Filters](https://docs.nestjs.com/websockets/exception-filters)

method catch

catch: (exception: T, host: ArgumentsHost) => any;

Method to implement a custom (web sockets) exception filter.
Parameter exception
the type (class) of the exception being handled
Parameter host
used to access an array of arguments for the in-flight message catch(exception: T, host: ArgumentsHost): any;

interface WsMessageHandler

interface WsMessageHandler<T = string> {}

property callback

callback: (...args: any[]) => Observable<any> | Promise<any>;

property message

message: T;

Enums

enum HttpStatus

enum HttpStatus {
    CONTINUE = 100,
    SWITCHING_PROTOCOLS = 101,
    PROCESSING = 102,
    EARLYHINTS = 103,
    OK = 200,
    CREATED = 201,
    ACCEPTED = 202,
    NON_AUTHORITATIVE_INFORMATION = 203,
    NO_CONTENT = 204,
    RESET_CONTENT = 205,
    PARTIAL_CONTENT = 206,
    AMBIGUOUS = 300,
    MOVED_PERMANENTLY = 301,
    FOUND = 302,
    SEE_OTHER = 303,
    NOT_MODIFIED = 304,
    TEMPORARY_REDIRECT = 307,
    PERMANENT_REDIRECT = 308,
    BAD_REQUEST = 400,
    UNAUTHORIZED = 401,
    PAYMENT_REQUIRED = 402,
    FORBIDDEN = 403,
    NOT_FOUND = 404,
    METHOD_NOT_ALLOWED = 405,
    NOT_ACCEPTABLE = 406,
    PROXY_AUTHENTICATION_REQUIRED = 407,
    REQUEST_TIMEOUT = 408,
    CONFLICT = 409,
    GONE = 410,
    LENGTH_REQUIRED = 411,
    PRECONDITION_FAILED = 412,
    PAYLOAD_TOO_LARGE = 413,
    URI_TOO_LONG = 414,
    UNSUPPORTED_MEDIA_TYPE = 415,
    REQUESTED_RANGE_NOT_SATISFIABLE = 416,
    EXPECTATION_FAILED = 417,
    I_AM_A_TEAPOT = 418,
    MISDIRECTED = 421,
    UNPROCESSABLE_ENTITY = 422,
    FAILED_DEPENDENCY = 424,
    PRECONDITION_REQUIRED = 428,
    TOO_MANY_REQUESTS = 429,
    INTERNAL_SERVER_ERROR = 500,
    NOT_IMPLEMENTED = 501,
    BAD_GATEWAY = 502,
    SERVICE_UNAVAILABLE = 503,
    GATEWAY_TIMEOUT = 504,
    HTTP_VERSION_NOT_SUPPORTED = 505,
}

member ACCEPTED

ACCEPTED = 202

member AMBIGUOUS

AMBIGUOUS = 300

member BAD_GATEWAY

BAD_GATEWAY = 502

member BAD_REQUEST

BAD_REQUEST = 400

member CONFLICT

CONFLICT = 409

member CONTINUE

CONTINUE = 100

member CREATED

CREATED = 201

member EARLYHINTS

EARLYHINTS = 103

member EXPECTATION_FAILED

EXPECTATION_FAILED = 417

member FAILED_DEPENDENCY

FAILED_DEPENDENCY = 424

member FORBIDDEN

FORBIDDEN = 403

member FOUND

FOUND = 302

member GATEWAY_TIMEOUT

GATEWAY_TIMEOUT = 504

member GONE

GONE = 410

member HTTP_VERSION_NOT_SUPPORTED

HTTP_VERSION_NOT_SUPPORTED = 505

member I_AM_A_TEAPOT

I_AM_A_TEAPOT = 418

member INTERNAL_SERVER_ERROR

INTERNAL_SERVER_ERROR = 500

member LENGTH_REQUIRED

LENGTH_REQUIRED = 411

member METHOD_NOT_ALLOWED

METHOD_NOT_ALLOWED = 405

member MISDIRECTED

MISDIRECTED = 421

member MOVED_PERMANENTLY

MOVED_PERMANENTLY = 301

member NO_CONTENT

NO_CONTENT = 204

member NON_AUTHORITATIVE_INFORMATION

NON_AUTHORITATIVE_INFORMATION = 203

member NOT_ACCEPTABLE

NOT_ACCEPTABLE = 406

member NOT_FOUND

NOT_FOUND = 404

member NOT_IMPLEMENTED

NOT_IMPLEMENTED = 501

member NOT_MODIFIED

NOT_MODIFIED = 304

member OK

OK = 200

member PARTIAL_CONTENT

PARTIAL_CONTENT = 206

member PAYLOAD_TOO_LARGE

PAYLOAD_TOO_LARGE = 413

member PAYMENT_REQUIRED

PAYMENT_REQUIRED = 402

member PERMANENT_REDIRECT

PERMANENT_REDIRECT = 308

member PRECONDITION_FAILED

PRECONDITION_FAILED = 412

member PRECONDITION_REQUIRED

PRECONDITION_REQUIRED = 428

member PROCESSING

PROCESSING = 102

member PROXY_AUTHENTICATION_REQUIRED

PROXY_AUTHENTICATION_REQUIRED = 407

member REQUEST_TIMEOUT

REQUEST_TIMEOUT = 408

member REQUESTED_RANGE_NOT_SATISFIABLE

REQUESTED_RANGE_NOT_SATISFIABLE = 416

member RESET_CONTENT

RESET_CONTENT = 205

member SEE_OTHER

SEE_OTHER = 303

member SERVICE_UNAVAILABLE

SERVICE_UNAVAILABLE = 503

member SWITCHING_PROTOCOLS

SWITCHING_PROTOCOLS = 101

member TEMPORARY_REDIRECT

TEMPORARY_REDIRECT = 307

member TOO_MANY_REQUESTS

TOO_MANY_REQUESTS = 429

member UNAUTHORIZED

UNAUTHORIZED = 401

member UNPROCESSABLE_ENTITY

UNPROCESSABLE_ENTITY = 422

member UNSUPPORTED_MEDIA_TYPE

UNSUPPORTED_MEDIA_TYPE = 415

member URI_TOO_LONG

URI_TOO_LONG = 414

enum RequestMethod

enum RequestMethod {
    GET = 0,
    POST = 1,
    PUT = 2,
    DELETE = 3,
    PATCH = 4,
    ALL = 5,
    OPTIONS = 6,
    HEAD = 7,
    SEARCH = 8,
}

member ALL

ALL = 5

member DELETE

DELETE = 3

member GET

GET = 0

member HEAD

HEAD = 7

member OPTIONS

OPTIONS = 6

member PATCH

PATCH = 4

member POST

POST = 1

member PUT

PUT = 2

member SEARCH

SEARCH = 8

enum Scope

enum Scope {
    DEFAULT = 0,
    TRANSIENT = 1,
    REQUEST = 2,
}

member DEFAULT

DEFAULT = 0

The provider can be shared across multiple classes. The provider lifetime is strictly tied to the application lifecycle. Once the application has bootstrapped, all providers have been instantiated.

member REQUEST

REQUEST = 2

A new instance is instantiated for each request processing pipeline

member TRANSIENT

TRANSIENT = 1

A new private instance of the provider is instantiated for every use

enum ShutdownSignal

enum ShutdownSignal {
    SIGHUP = 'SIGHUP',
    SIGINT = 'SIGINT',
    SIGQUIT = 'SIGQUIT',
    SIGILL = 'SIGILL',
    SIGTRAP = 'SIGTRAP',
    SIGABRT = 'SIGABRT',
    SIGBUS = 'SIGBUS',
    SIGFPE = 'SIGFPE',
    SIGSEGV = 'SIGSEGV',
    SIGUSR2 = 'SIGUSR2',
    SIGTERM = 'SIGTERM',
}

System signals which shut down a process

member SIGABRT

SIGABRT = 'SIGABRT'

member SIGBUS

SIGBUS = 'SIGBUS'

member SIGFPE

SIGFPE = 'SIGFPE'

member SIGHUP

SIGHUP = 'SIGHUP'

member SIGILL

SIGILL = 'SIGILL'

member SIGINT

SIGINT = 'SIGINT'

member SIGQUIT

SIGQUIT = 'SIGQUIT'

member SIGSEGV

SIGSEGV = 'SIGSEGV'

member SIGTERM

SIGTERM = 'SIGTERM'

member SIGTRAP

SIGTRAP = 'SIGTRAP'

member SIGUSR2

SIGUSR2 = 'SIGUSR2'

enum VersioningType

enum VersioningType {
    URI = 0,
    HEADER = 1,
    MEDIA_TYPE = 2,
    CUSTOM = 3,
}

member CUSTOM

CUSTOM = 3

HEADER = 1

member MEDIA_TYPE

MEDIA_TYPE = 2

member URI

URI = 0

Type Aliases

type ConfigurableModuleCls

type ConfigurableModuleCls<
    ModuleOptions,
    MethodKey extends string = typeof DEFAULT_METHOD_KEY,
    FactoryClassMethodKey extends string = typeof DEFAULT_FACTORY_CLASS_METHOD_KEY,
    ExtraModuleDefinitionOptions = {}
> = {
    new (): any;
} & Record<
    `${MethodKey}`,
    (options: ModuleOptions & Partial<ExtraModuleDefinitionOptions>) => DynamicModule
> &
    Record<
        `${MethodKey}Async`,
        (
            options: ConfigurableModuleAsyncOptions<
                ModuleOptions,
                FactoryClassMethodKey
            > &
                Partial<ExtraModuleDefinitionOptions>
        ) => DynamicModule
    >;

Class that represents a blueprint/prototype for a configurable Nest module. This class provides static methods for constructing dynamic modules. Their names can be controlled through the "MethodKey" type argument.

type ConfigurableModuleOptionsFactory

type ConfigurableModuleOptionsFactory<
    ModuleOptions,
    FactoryClassMethodKey extends string
> = Record<`${FactoryClassMethodKey}`, () => Promise<ModuleOptions> | ModuleOptions>;

Interface that must be implemented by the module options factory class. Method key varies depending on the "FactoryClassMethodKey" type argument.

type ContextType

type ContextType = 'http' | 'ws' | 'rpc';

type CustomDecorator

type CustomDecorator<TKey = string> = MethodDecorator &
    ClassDecorator & {
        KEY: TKey;
    };

type FileTypeValidatorOptions

type FileTypeValidatorOptions = {
    fileType: string | RegExp;
};

type HttpExceptionBodyMessage

type HttpExceptionBodyMessage = string | string[];

type InjectableOptions

type InjectableOptions = ScopeOptions;

Defines the injection scope.
See Also
- [Injection Scopes](https://docs.nestjs.com/fundamentals/injection-scopes)

type InjectionToken

type InjectionToken<T = any> = string | symbol | Type<T> | Abstract<T> | Function;

type LogLevel

type LogLevel = 'log' | 'error' | 'warn' | 'debug' | 'verbose' | 'fatal';

type MaxFileSizeValidatorOptions

type MaxFileSizeValidatorOptions = {
    maxSize: number;
    message?: string | ((maxSize: number) => string);
};

type OptionalFactoryDependency

type OptionalFactoryDependency = {
    token: InjectionToken;
    optional: boolean;
};

type ParamData

type ParamData = object | string | number;

type ParamDecoratorEnhancer

type ParamDecoratorEnhancer = ParameterDecorator;

type Paramtype

type Paramtype = 'body' | 'query' | 'param' | 'custom';

type Provider

type Provider<T = any> =
    | Type<any>
    | ClassProvider<T>
    | ValueProvider<T>
    | FactoryProvider<T>
    | ExistingProvider<T>;

type RawBodyRequest

type RawBodyRequest<T> = T & {
    rawBody?: Buffer;
};

type VersioningOptions

type VersioningOptions = VersioningCommonOptions &
    (
        | HeaderVersioningOptions
        | UriVersioningOptions
        | MediaTypeVersioningOptions
        | CustomVersioningOptions
    );

Package Files (116)

Dependencies (3)

Dev Dependencies (0)

No dev dependencies.

Peer Dependencies (4)

Badge

To add a badge like this oneto your package's README, use the codes available below.

You may also use Shields.io to create a custom badge linking to https://www.jsdocs.io/package/@nestjs/common.

Markdown

[![jsDocs.io](https://img.shields.io/badge/jsDocs.io-reference-blue)](https://www.jsdocs.io/package/@nestjs/common)

HTML

<a href="https://www.jsdocs.io/package/@nestjs/common"><img src="https://img.shields.io/badge/jsDocs.io-reference-blue" alt="jsDocs.io"></a>

Updated 4 seconds ago.
Package analyzed in 7367 ms.
Missing or incorrect documentation? Open an issue for this package.

@nestjs/common

Install

Overview

Index

Variables

Functions

Classes

Interfaces

Enums

Type Aliases

Variables

variable VERSION_NEUTRAL

Functions

function All

See Also

function applyDecorators

Parameter decorators

function assignMetadata

function Bind

Parameter decorators

function Body

See Also

Parameter pipes

See Also

Parameter property

Parameter pipes

See Also

function Catch

Parameter exceptions

See Also

function Controller

See Also

Parameter prefix

See Also

Parameter options

See Also

function createParamDecorator

Parameter factory

Parameter enhancers

function Delete

See Also

function Dependencies

function flatten

function forwardRef

function Get

See Also

function Global

See Also

function Head

See Also

function Header

Parameter name

Parameter value

See Also

function Headers

Parameter property

See Also

function HostParam

Parameter property

See Also

function HttpCode

Parameter statusCode

See Also

function Inject

Parameter token

See Also

function Injectable

Parameter options

See Also

function Ip

See Also

function mixin

function Module

Parameter metadata

See Also

function Next

function Optional

See Also

function Options

See Also