Safely handle promise rejections
Useful for codes that are way out of your league and you want to handle everything! (e.g. API calls)
npm install p-safeimport { 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); // undefinedOr 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.
- 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…