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)

$3

``bash
npm install p-safe
`

$3

`typescript
import { trySafe } from 'p-safe';

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

// Return type is SafeReturn

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

console.log(error); // undefined
`

Or implement your function and only use SafeReturn type:

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

async function foo(): Promise> {
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.

$3

- 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…

$3

MIT © Shahrad Elahi