Skip to content

osoclos/czy-js

Repository files navigation

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!

About

Try-catch Replacement for JavaScript

Resources

License

Stars

Watchers

Forks