How to Handle Async Errors in Node.js Correctly

In Node.js, handle async errors by using try/catch blocks around await calls in async functions or by checking the error argument in error-first callbacks. This ensures your app catches errors properly and avoids crashes.

Why This Happens

Async errors happen because asynchronous code runs separately from the main flow, so errors inside async functions or callbacks don't automatically stop the program or get caught by normal try/catch. If you forget to handle these errors, your app can crash or behave unpredictably.

javascript

const fs = require('fs');

async function readFile() {
  try {
    const data = await fs.readFile('nonexistent.txt', 'utf8'); // Added await
    console.log(data);
  } catch (err) {
    console.error('Caught error:', err);
  }
}

readFile();

Output

undefined
(node:...) UnhandledPromiseRejectionWarning: Error: ENOENT: no such file or directory, open 'nonexistent.txt'
    at ...

The Fix

Use await with async functions inside try/catch to catch errors properly. For callback-based async functions, always check the error argument first. This way, errors are caught and handled gracefully.

javascript

const fs = require('fs').promises;

async function readFile() {
  try {
    const data = await fs.readFile('nonexistent.txt', 'utf8');
    console.log(data);
  } catch (err) {
    console.error('Caught error:', err.message);
  }
}

readFile();

Output

Caught error: ENOENT: no such file or directory, open 'nonexistent.txt'

Prevention

Always use async/await with try/catch for promises. For callbacks, check the error argument first. Use tools like linting to warn about unhandled promises. Consider using .catch() on promises if not using async/await. This keeps your app stable and easier to debug.

Related Errors

Common related errors include UnhandledPromiseRejectionWarning when promises reject without a catch, and Callback called multiple times when error handling is done incorrectly. Fix these by always handling errors in every async path.

Key Takeaways

Use try/catch blocks around await calls to catch async errors.

Always check the error argument in callbacks before proceeding.

Use linting tools to detect unhandled promises.

Attach .catch() to promises if not using async/await.

Proper error handling prevents app crashes and improves debugging.