JSPM

  • Created
  • Published
  • Downloads 481994
  • Score
    100M100P100Q181806F
  • License Apache-2.0

Custom error types and error factory functions

Package Exports

  • @thi.ng/errors
  • @thi.ng/errors/illegal-arguments
  • @thi.ng/errors/illegal-arity
  • @thi.ng/errors/illegal-state
  • @thi.ng/errors/unsupported

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@thi.ng/errors) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

errors

npm version npm downloads Twitter Follow

This project is part of the @thi.ng/umbrella monorepo.

About

Custom error types and error factory functions.

Additional error types can be defined using defError().

Status

STABLE - used in production

Installation

yarn add @thi.ng/errors

Package sizes (gzipped, pre-treeshake): ESM: 262 bytes / CJS: 338 bytes / UMD: 403 bytes

Dependencies

API

Generated API docs

import * as err from "@thi.ng/errors";

err.illegalArity(3)
// Error: illegal arity: 3

err.illegalArgs("expected foo");
// Error: illegal argument(s): expected foo

err.illegalState("oops");
// Error: illegal state: oops

err.unsupported("TODO not yet implemented")
// Error: unsupported operation: TODO not yet implemented

// define custom error
const MyError = err.defError(
    () => "Eeek... ",
    (x) => x + " is not allowed!"
);

try {
    throw new MyError(23);
} catch(e) {
    console.warn(e.message);
    console.log(e instanceof Error);
}
// Eeek... 23 is not allowed!
// true

Authors

Karsten Schmidt

License

© 2018 - 2020 Karsten Schmidt // Apache Software License 2.0