How to Handle Errors in Node.js: Simple and Effective Methods

In Node.js, handle errors by using try-catch blocks for synchronous code and async/await with try-catch for asynchronous code. For callback-based functions, always check the error argument first to manage errors properly.

Why This Happens

Errors happen when your code tries to do something that fails, like reading a file that doesn't exist or calling a function with wrong data. If you don't handle these errors, your program can crash or behave unexpectedly.

javascript

const fs = require('fs');

const data = fs.readFileSync('missingfile.txt', 'utf8');
console.log(data);

Output

Error: ENOENT: no such file or directory, open 'missingfile.txt'

The Fix

Wrap your code in try-catch blocks to catch errors and handle them gracefully. For asynchronous code, use async/await with try-catch or check the error in callbacks.

javascript

const fs = require('fs');

try {
  const data = fs.readFileSync('missingfile.txt', 'utf8');
  console.log(data);
} catch (error) {
  console.error('File read failed:', error.message);
}

// Async example with async/await
async function readFileAsync() {
  try {
    const data = await fs.promises.readFile('missingfile.txt', 'utf8');
    console.log(data);
  } catch (error) {
    console.error('Async file read failed:', error.message);
  }
}
readFileAsync();

Output

File read failed: ENOENT: no such file or directory, open 'missingfile.txt'
Async file read failed: ENOENT: no such file or directory, open 'missingfile.txt'

Prevention

Always anticipate errors by validating inputs and using try-catch for synchronous code and async/await with try-catch for asynchronous code. Use linting tools like ESLint to catch common mistakes early. Avoid ignoring errors in callbacks by always checking the first error argument.

Related Errors

Common related errors include unhandled promise rejections, which happen when promises fail but no catch is used, and callback errors ignored by missing error checks. Fix these by always adding catch blocks for promises and checking errors in callbacks.

Key Takeaways

Use try-catch blocks to handle errors in synchronous Node.js code.

For asynchronous code, use async/await with try-catch or check errors in callbacks.

Always check the error argument in callbacks to avoid silent failures.

Validate inputs and use linting tools to prevent common mistakes.

Handle promise rejections with catch to avoid unhandled errors.