README.md

chilled-js

What if JavaScript could chill a little bit with all the errors being thrown here and there?

TL;DR

function parse(raw) {
  try {
    return [ null, JSON.parse(raw) ]
  } catch (err) {
    return [ err, null ]
  }
}

let [ err, ok ] = parse(...)

Comparing to other kinds of error handling

	Nullable	try..catch and throw	Callback	Promise	chilled
Sync	✔️	✔️			✔️
Async			✔️	✔️	✔️
Error Context		😕	✔️	✔️	✔️
Composability	✔️			✔️	✔️

Usage

Sync

Helps to capture the error close to the context when working with functions which throw exceptions.

const parse = chill(JSON.parse)

let [ err, ok ] = parse('{ "id": 1 }')

if (err) {
  // Handle the error.
}

console.log(ok)

Async

Removes exception bubbling when using Async Await.

const url = 'https://jsonplaceholder.typicode.com/todos/1'

async function () {
  let [ err, ok ] = await chill(
    () => fetch(url).then(response => response.json())
  )()

  if (err) {
    // Handle the error.
  }

  // Celebrate the success at async programming!
  console.log(ok)
}()

Inspiration

• Error handling and Go
• Result type from Elm
• Data.Either type from Haskell
• scopsy/await-to-js a JavaScript library exploring a similar concept