p-safe

Safely handle promise rejections

Useful for codes that are way out of your league and you want to handle everything! (e.g. API calls)

Install

npm install p-safe

Usage

import { trySafe } from 'p-safe';

const { error } = trySafe<void, CustomError>(async (_, reject) => {
  await promiseThatMightReject();
  const { statusText } = await fetch('...');
  if (statusText !== 'OK') {
    reject(new CustomError('Request failed for a silly reason'));
  }
});

// Return type is `SafeReturn<void, CustomError>`

if (error) {
  // Handle error
  return console.error(error);
}

console.log(error); // undefined

Or implement your function and only use SafeReturn type:

import type { SafeReturn } from 'p-safe';

async function foo(): Promise<SafeReturn<object, Error>> {
  const resp = await fetch('...');
  if (!resp.ok) {
    return { error: new Error('Request failed for a silly reason') };
  }
  return { data: await resp.json() };
}

const { data, error } = await foo();

if (error) {
  console.log(error); // ERROR
  console.log(data); // undefined
  return;
}

console.log(error); // undefined
console.log(data); // { ... }

Are you still confused? Let me explain it in a simple way. p-safe is a simple utility that helps you to safely handle promise rejections. It's a simple and clean way to handle promise rejections without using try/catch blocks.

Check out the tests for more examples.

Related

• p-catch-if - Conditional promise catch handler
• p-if - Conditional promise chains
• p-tap - Tap into a promise chain without affecting its value or state
• p-log - Log the value/error of a promise
• More…

License

MIT © Shahrad Elahi