Core
Guides v2.x
2

errors #

The context.errors object regroups all error objects, used in request responses, or to be used by the protocol if needs be.


KuzzleError #

Inherits from the standard Javascript Error object: abstract class inherited by all Kuzzle error objects.

This class should only be used to create new Kuzzle error objects.

Properties #

PropertiesTypeDescription
message
string
Error message
stack
string[]
Error stack trace (not available in production mode)
status
integer
Error status code, following the standard HTTP status code

BadRequestError #

Invalid request syntax.

Status code #

400

Example #

const err = new context.errors.BadRequestError('error message');

ExternalServiceError #

External service failure.

Status Code #

500

Example #

const err = new context.errors.ExternalServiceError('error message');

ForbiddenError #

Unauthorized access to a resource.

Status Code #

403

Example #

const err = new context.errors.ForbiddenError('error message');

GatewayTimeoutError #

Timeout error.

Status code #

504

Example #

const err = new context.errors.GatewayTimeoutError('error message');

InternalError #

Unexpected error. Should be reserved for Kuzzle's use only.

Status Code #

500

Example #

const err = new context.errors.InternalError('error message');

NotFoundError #

Resource not found.

Status Code #

404

Example #

const err = new context.errors.NotFoundError('error message');

Status Code #

400

Example #

const err = new context.errors.ParseError('error message');

PartialError #

Partial request success.

Constructor #

new context.error.PartialError(message, errors);

ArgumentsTypeDescription
message
string
Error message
failuresKuzzleError[]List of encountered errors

Status Code #

206

Example #

const err = new context.errors.PartialError('error message', [
  new context.errors.BadRequestError('[request part] invalid format'),
  new context.errors.ForbiddenError('[other request part] forbidden')
]);

PluginImplementationError #

Unexpected plugin failure.

Status Code #

500

Example #

const err = new context.errors.PluginImplementationError('error message');

PreconditionError #

Unmet request prerequisites.

Status Code #

412

Example #

const err = new context.errors.PreconditionError('error message');

ServiceUnavailableError #

Temporarily unable to respond.

Status Code #

503

Example #

const err = new context.errors.ServiceUnavailableError('error message');

SizeLimitError #

KuzzleRequest exceeds the maximum limits.

Status Code #

413

Example #

const err = new context.errors.SizeLimitError('error message');

UnauthorizedError #

Authentication failed.

Status Code #

401

Example #

const err = new context.errors.UnauthorizedError('error message');