layerr

Layerr

Errors, with.. layers..

A NodeJS and Web Error wrapping utility, based heavily on VError, but without all the extras and dependencies on Node core utilities. Written in Typescript, compiled to JavaScript and suitable for bundling in the browser.

Uses no dependencies, minifies well and is a great way to wrap errors as they propagate through complex applications (such as Express services, for instance).

Layerr is an ESM library, and as such you need a compatible environment in which to install and use it.

Installation

Install by running: npm install layerr.

Usage

Use it as a regular error:

const { Layerr } = require("layerr");

throw new Layerr("Test error");

Or use it to wrap errors:

doSomething().catch((err) => {
    throw new Layerr(err, "Failed doing something");
});

Layerr's can have info attached:

const { Layerr } = require("layerr");

function somethingElse() {
    throw new Layerr(
        {
            info: {
                code: 123,
            },
        },
        "Problem"
    );
}

somethingElse().catch((err: Layerr) => {
    const { code } = Layerr.info(err);
    // code === 123
});

Global Name

By default Layerr names all created errors as Layerr. You can change this name by calling setGlobalName, and revert it by passing null to this function:

import { Layerr, setGlobalName } from "layerr";

setGlobalName("CustomError");

const err = new Layerr("My error");

err.name; // "CustomError"

throw err;
// Uncaught Layerr [CustomError]: My error

Support

Layerr (v3) supports NodeJS 16 onwards. It should also support all major+current browsers, once compiled/bundled.

Changelog

v3.0.0

2024-04-22

• Removed Layerr#cause due to typescript issues
• setGlobalName helper
• Strict mode types

Similar packages

Other packages similar to layerr

verror

The 'verror' package provides a similar functionality to 'layerr' by allowing you to create and manage nested errors. It also provides utilities for adding context to errors and for checking if an error is a nested error. Compared to 'layerr', 'verror' has a more extensive API for error manipulation and inspection.

error-stack-parser

The 'error-stack-parser' package focuses on parsing and extracting information from error stack traces. While it does not provide layered error functionality, it can be used in conjunction with 'layerr' to analyze and handle errors more effectively. It is more specialized in stack trace parsing compared to 'layerr'.

stack-trace

The 'stack-trace' package provides utilities for capturing and manipulating stack traces in JavaScript. It can be used to enhance error handling by providing detailed stack trace information. While it does not offer layered error functionality, it complements 'layerr' by providing more control over stack trace information.