catry

Catry

A simple async/sync catry function for safe error handling in Node.js and browser.

Installation

npm install catry

Usage

This library provides a simple way to handle errors without using try/catch blocks. It returns an object with error and result properties, making error handling more ergonomic and eliminating the need for explicit try/catch blocks.

The guard function takes a function as an argument and safely executes it, returning an object with error and result properties.

For synchronous functions, it returns the result directly. For asynchronous functions, it awaits the result.

/*
 Example 1: Basic usage of the guard function
*/

// Import the guard function
const catry = require('catry');

// This demonstrates safe error handling - no try/catch needed
const { error, result } = await catry(() => 1 + 1);

// Output shows that error is undefined and result is 2
console.log('Example 1 result:', error); // Should be undefined
console.log('Example 1 result:', result); // Should be 2

/*
 Example 2: Handling errors with guard function
*/

// Import the guard function
const catry = require('catry');

// This demonstrates safe error handling - no try/catch needed
const { error, result } = await catry(() => {
    throw new Error('Something went wrong');
});

// Output shows that error contains the error and result is undefined
console.log('Error:', error?.message); // Should print the error message
console.log('Result:', result); // Should be undefined

License

MIT License

Author

Manish Gautam