unwrapit

unwrapit provides a graceful way to handle errors in JavaScript and TypeScript. It wraps values, promises, and functions in a Result object so success and failure paths stay explicit.

npm i unwrapit

import {wrap} from 'unwrapit'

async function main() {
  const get = wrap(fetch)
  const res = await get('https://example.com')

  if (!res.ok) {
    console.error(res.error)
    return
  }

  console.log(res.value.status)
}

main()

Why use it?

JavaScript exceptions are easy to miss because they are invisible in a function's type. A function can look harmless from its signature, then still throw at runtime and crash the program.

unwrapit makes fallible work return a Result<T, E> instead:

const parseJson = wrap(JSON.parse)
const result = parseJson('{"package":"unwrapit"}')

const name = result.match({
  Ok: value => value.package,
  Err: error => {
    console.error(error)
    return 'unknown'
  },
})

Why Use It walks through the original crash and try/catch examples from the GitBook docs.

Start here

• Getting Started shows the core workflow.
• Why Use It explains the problem unwrapit is solving.
• Result Flow explains ok, err, and narrowing.
• API Reference documents every exported API, including match.
• Maintaining Docs explains the local and Vercel docs workflow.