Api References NestJS

ImATeapotException

class

Defines an HTTP exception for ImATeapotException type errors.

  
class ImATeapotException extends HttpException {
  constructor(objectOrError?: any, descriptionOrOptions: string | HttpExceptionOptions = `I'm a teapot`)

  // inherited from nest/packages/common/HttpException
  static createBody(objectOrErrorMessage: string | object, description?: string, statusCode?: number)
  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: Error | undefined
  initCause(): void
  initMessage()
  initName(): void
  getResponse(): string | object
  getStatus(): number
}

Constructor

Instantiate an ImATeapotException Exception.


constructor(objectOrError?: any, descriptionOrOptions: string | HttpExceptionOptions = `I'm a teapot`)

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 ``I'm a teapot``.

Examples

    
`throw new ImATeapotException()`

Usage Notes

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.

Description

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#

Constructor

Parameters

Examples

Usage Notes#

Description#

See also

Usage Notes

Description