Why robust error handling matters in Node.js - See It in Action

Why robust error handling matters

📖 Scenario: You are building a simple Node.js app that reads user data from a file and processes it. Sometimes the file might be missing or unreadable. You want to make sure your app handles these problems gracefully without crashing.

🎯 Goal: Build a Node.js script that reads a JSON file, handles possible errors like missing file or read errors, and logs meaningful messages instead of crashing.

📋 What You'll Learn

Create a variable called fs that imports the Node.js fs/promises module.

Create a variable called filePath with the exact string "./userdata.json".

Write an async function called readUserData that reads the file at filePath.

Use try...catch inside readUserData to catch errors from reading the file.

In the catch block, log the error message "Error reading user data:" followed by the error.

Call readUserData at the end of the script.

💡 Why This Matters

🌍 Real World

In real apps, files or external data sources can fail or be corrupted. Robust error handling keeps apps stable and user-friendly.

💼 Career

Error handling is a key skill for backend developers working with Node.js to build reliable, maintainable services.

1

Set up file system import and file path

Create a variable called fs that imports the Node.js fs/promises module using import. Then create a variable called filePath and set it to the string "./userdata.json".

Node.js

import fs from 'fs/promises';
// Your code here

Need a hint?

Use import fs from 'fs/promises' to get the file system promises API. Then assign filePath to the exact string "./userdata.json".

2

Create async function to read file

Write an async function called readUserData with no parameters. Inside it, use await fs.readFile(filePath, 'utf-8') to read the file contents into a variable called data.

Node.js

import fs from 'fs/promises';
const filePath = "./userdata.json";

async function readUserData() {
  // Your code here
}

Need a hint?

Define async function readUserData(). Use await fs.readFile(filePath, 'utf-8') to read the file as text.

3

Add try...catch for error handling

Wrap the file reading code inside a try block. Add a catch block that catches any error as err and logs "Error reading user data:" followed by err.message using console.error.

Node.js

import fs from 'fs/promises';
const filePath = "./userdata.json";

async function readUserData() {
  try {
    // Your code here
  } catch (err) {
    // Your code here
  }
}

Need a hint?

Use try { ... } catch (err) { console.error("Error reading user data:", err.message) } to handle errors.

4

Call the async function to run it

At the end of the script, call the readUserData() function to execute the file reading and error handling.

Node.js

import fs from 'fs/promises';
const filePath = "./userdata.json";

async function readUserData() {
  try {
    const data = await fs.readFile(filePath, 'utf-8');
  } catch (err) {
    console.error("Error reading user data:", err.message);
  }
}

// Your code here

Need a hint?

Simply call readUserData() at the end of your script.