@nestjs/common
Version:
Nest - modern, fast, powerful node.js web framework (@common)
40 lines (39 loc) • 2.03 kB
JavaScript
import { HttpStatus } from '../enums/http-status.enum.js';
import { HttpException } from './http.exception.js';
/**
* Defines an HTTP exception for *Not Acceptable* type errors.
*
* @see [Built-in HTTP exceptions](https://docs.nestjs.com/exception-filters#built-in-http-exceptions)
*
* @publicApi
*/
export class NotAcceptableException extends HttpException {
/**
* Instantiate a `NotAcceptableException` Exception.
*
* @example
* `throw new NotAcceptableException()`
*
* @usageNotes
* 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.
* - `message`: the string `'Not Acceptable'` 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.
*
* @param objectOrError string or object describing the error condition.
* @param descriptionOrOptions either a short description of the HTTP error or an options object used to provide an underlying error cause
*/
constructor(objectOrError, descriptionOrOptions = 'Not Acceptable') {
const { description = 'Not Acceptable', httpExceptionOptions } = HttpException.extractDescriptionAndOptionsFrom(descriptionOrOptions);
super(HttpException.createBody(objectOrError, description, HttpStatus.NOT_ACCEPTABLE), HttpStatus.NOT_ACCEPTABLE, httpExceptionOptions);
}
}