Czy.js - Try-catch Replacement for JavaScript

Introduction

Czy.js (pronounced as t͡ʃʲɨ, means "whether" in Polish) is a simple yet intuitive drop-in replacement for the try-catch block, which is notorious for its scoping and error typing issues. This library aims to fix that once and for all!

Installation

$ npm install czy-js

Usage

import czy from "czy-js";

const { data, err } = await czy(fetch("..."));

// throw the error if it exists...
if (err) throw err;

// otherwise use the data
console.log(data);

// this works for non-async functions as well:
const { data, err } = czy(someNonAsyncFunc());

// if you prefer to do a success === true/false check, it is possible to do that as well!
const { success, data } = await czy(fetch("..."));

// if you are confident, you can immediately resolve it as a one-liner!
const data = await czy(fetch("...")).resolve();

// it is also possible to destructure the output as an array:
const [err, data] = await czy(fetch("..."));

// if you rather destructure as data-first, this option is available too!
const [data, err] = await czy.dataErr(fetch("..."));

Documentation

More detailed docs will be available soon!