Try-Catch Library

Description

The Try-Catch library provides a simple and elegant way to handle exceptions in JavaScript/TypeScript using custom Try and Catch blocks. This library makes it easier to capture and handle specific errors, improving code readability and maintainability.

Installation

You can install the Try-Catch library using npm or yarn.

Using npm

npm install @arsat/try-catch

Using npm

yarn add @arsat/try-catch

Usage

Here is an example of how to use the Try-Catch library:

import { Try, Catch, Finally } from "@arsat/try-catch";
import { IsZeroError, NotNumberError } from "./errors";

function divide(a: number, b: number): number {
  if (b === 0) {
    throw new IsZeroError();
  }
  if (isNaN(a) || isNaN(b)) {
    throw new NotNumberError();
  }
  return a / b;
}

const result = await Try(
  async () => {
    return divide(10, 0);
  },
  Catch(IsZeroError, (error) => {
    console.error("Caught an IsZeroError:", error.message);
    return NaN;
  }),
  Catch(NotNumberError, (error) => {
    console.error("Caught an NotNumberError:", error.message);
    throw error;
  }),
  Finally(() => {
    console.log("Always execute");
  })
);

This example demonstrates how to use the Try, Catch, and Finally blocks to handle specific errors (IsZeroError and NotNumberError) when dividing numbers.

You can add as many Catch sections as needed, and only the first one that can handle the error will be executed. If none can handle the error, it will propagate. Additionally, an optional Finally block can be added at the end, which will always execute regardless of whether an error was thrown or not.