README
imperfect
A Technical Error Provider.
Usage
If you build a transport layer, ...
... you can implement the handling of the Technical Errors provided by imperfect,
so that when someone uses your layer, and an imperfect-Error ist thrown, you can handle it correctly
If you want to use imperfect-Errors, ...
... You can just use the Errors provided by imperfect directly, or write your own
non-technical errors that extend imperfect-Errors.
Every library (mostly transport layers) that can handle imperfect-Errors will be
able to also correctly handle Errors that extend a imperfect-Error
Either way
you just need to npm install --save imperfect,
and then require('imperfect').ERRORNAME,
where ERRORNAME is the name of one of the imperfect-Errors.
all imperfect-errors have the isTechnicalError-property, so they can be identified as imperfect-errors
Errors
The Errors are mostly based on http-status-codes.
Every Error, except for the BaseError directly extends BaseError, and
BaseError extends Error
| name | code |
|---|---|
| BaseError | |
| information-errors | 1xx |
| ContinueError | 101 |
| SwitchingProtocolsError | 102 |
| ProcessingError | 103 |
| redirect-errors | 3xx |
| MultipleChoicesError | 300 |
| MovedError | 301 |
| FoundError | 302 |
| SeeOtherError | 303 |
| NotModifiedError | 304 |
| UseProxyError | 305 |
| TemporaryRedirectError | 307 |
| PermanentRedirectError | 308 |
| client-errors | 4xx |
| BadRequestError | 400 |
| UnauthorizedError | 401 |
| PaymentRequiredError | 402 |
| ForbiddenError | 403 |
| NotFoundError | 404 |
| MethodNotAllowedError | 405 |
| NotAcceptableError | 406 |
| ProxyAuthenticationRequiredError | 407 |
| RequestTimeoutError | 408 |
| ConflictError | 409 |
| GoneError | 410 |
| LengthRequiredError | 411 |
| PreconditionFailedError | 412 |
| RequestTooLargeError | 413 |
| URLTooLongError | 414 |
| UnsupportedMediaTypeError | 415 |
| RequestedRangeNotSatisfiableError | 416 |
| ExpectationFailedError | 417 |
| ImATeapotError | 418 |
| PolicyNotFulfilledError | 420 |
| MisdirectredRequestError | 421 |
| UnprocessableEntityError | 422 |
| LockedError | 423 |
| FailedDependencyError | 424 |
| UpgradeRequiredError | 426 |
| PreconditionRequiredError | 428 |
| TooManyRequestsError | 429 |
| RequestHeaderTooLargeError | 431 |
| UnavaliableForLegalReasonsError | 451 |
| server-errors | 5xx |
| InternalServerError | 500 |
| NotImplementedError | 501 |
| BadGatewayError | 502 |
| ServiceUnavaliableError | 503 |
| GatewayTimeoutError | 504 |
| VersionNotSupportedError | 505 |
| InsufficientStorageError | 507 |
| LoopDetectedError | 508 |
| BandwithLimitExceededError | 509 |
| NetworkAuthenticationRequiredError | 511 |