better-try-catch

better-try-catch

Try-catch wrapper for easy error handling. Inspired by await-to-js.

Installation

$ npm install better-try-catch

Usage

var btc = require('better-try-catch')

var [err, result] = btc(someFunction)(arg1, arg2)
if (!err) {
  // ...
}

// You can also use better-try-catch with async/await functions
async function example1() {
  var [err, result] = await btc(someFunctionThatReturnsPromise)(arg1, arg2)
  if (!err) {
    // ...
  }
}

// Or even use with functions that accept node-style callback:
async function example2() {
  var [err, result] = await btc.promisify(fs.readFile)('data.json', 'utf8')
}

I didn't see it's "better"?

Consider a situation like this:

try {
  doSomething()
} catch (err) {
  // The varaible `err` is only visible in the catch block
}
// With the code goes here, the variable `err` is no longer existing
// If we have to make sure there wasn't anything went wrong above
// How do we know that?
if (!err) {
  // ...
}

Humm, it should be not too hard to solve. After one or three minutes of thinking, we have the code rearranged to be like this:

var err // Hoist the error variable declaration
try {
  doSomething()
} catch (ex) {
  err = ex // Notice here
  // Also, we can not simply place the `if` statement inside the catch block
  // Since if no errors occured then the `if` statement will not execute at all
}
// Alright, this time we are able to safely access the error variable outside the try-catch block
if (!err) {
  // ...
}

Okay, seems the problem has gone, with the only exception that the code looks a little more messy now. C'mon! Can't we do it better? better-try-catch to the rescue™!

var btc = require('better-try-catch')
// better-try-catch wraps the function and will catch errors for you
// The wrapped function will *always* return both error and value
// Which somewhat looks like the node-style callbacks
var [err, result] = btc(doSomething)()
// And that's all we have to do, as simple as you can see
if (!err) { // Was there anything went wrong?
  // Nope, we are perfectly sure that everthing is running well as expected! :D
}

License

MIT License, Copyright (c) 2017 Riophae Lee