UnprocessableEntityException

Defines an HTTP exception for Unprocessable Entity type errors.

  
class UnprocessableEntityException extends HttpException {
  constructor(objectOrError?: any, descriptionOrOptions: string | HttpExceptionOptions = 'Unprocessable Entity')

  // inherited from nest/packages/common/HttpException
  static createBody<Body extends Record<string, unknown>>(arg0: HttpExceptionBodyMessage | Body, arg1?: HttpExceptionBodyMessage, statusCode?: number): HttpExceptionBody | Body
  static getDescriptionFrom(descriptionOrOptions: string | HttpExceptionOptions): string
  static getHttpExceptionOptionsFrom(descriptionOrOptions: string | HttpExceptionOptions): HttpExceptionOptions
  static extractDescriptionAndOptionsFrom(descriptionOrOptions: string | HttpExceptionOptions): DescriptionAndOptions
  constructor(response: string | Record<string, any>, status: number, options?: HttpExceptionOptions)
  cause: unknown
  initCause(): void
  initMessage()
  initName(): void
  getResponse(): string | object
  getStatus(): number

  // inherited from nest/packages/common/IntrinsicException
}

See also

Constructor

Instantiate an UnprocessableEntityException Exception.


constructor(objectOrError?: any, descriptionOrOptions: string | HttpExceptionOptions = 'Unprocessable Entity')

Parameters

Option Type Description
objectOrError any

string or object describing the error condition.


Optional. Default is `undefined`.
descriptionOrOptions string | HttpExceptionOptions

either a short description of the HTTP error or an options object used to provide an underlying error cause


Optional. Default is `'Unprocessable Entity'`.

Examples

    
`throw new UnprocessableEntityException()`

Usage Notes

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.