Why Checking file existence and stats in Node.js? - Purpose & Use Cases

The Big Idea

What if your app could avoid crashes just by checking files first?

The Scenario

Imagine you have a folder full of files and you want to know if a specific file is there and what size it is before you use it.

You try to open the file directly without checking, or you guess its size by looking at it manually.

The Problem

Manually opening files without checking can cause your program to crash if the file is missing.

Guessing file details wastes time and can lead to errors, especially when files change often.

The Solution

Node.js provides simple functions to check if a file exists and to get its details safely.

This means your program can handle missing files gracefully and use file information correctly every time.

Before vs After

✗ Before

const fs = require('fs');
const file = fs.readFileSync('data.txt'); // crashes if missing

✓ After

const fs = require('fs');
if (fs.existsSync('data.txt')) {
  const stats = fs.statSync('data.txt');
  console.log(`Size: ${stats.size}`);
}

What It Enables

This lets your app work smoothly with files, avoiding crashes and making smart decisions based on file info.

Real Life Example

Think of a photo app that checks if a picture file exists before trying to show it, so it never shows a broken image.

Key Takeaways

Manually handling files can cause crashes and errors.

Node.js offers easy ways to check file existence and get stats.

This makes file handling safe and reliable in your programs.

Practice

1. Which Node.js method is best to check if a file exists without throwing an error?

easy

A. fs.writeFile

B. fs.readFile

C. fs.open

D. fs.access

Solution

1. Step 1: Understand file existence check methods

   fs.access is designed to check file accessibility without opening or reading it.

2. Step 2: Compare with other methods

   fs.readFile reads content, fs.open opens file descriptor, fs.writeFile writes data. These are not meant for existence check.

3. Final Answer:

   fs.access -> Option D

4. Quick Check:

   Check file existence = fs.access [OK]

Hint: Use fs.access to check file existence safely [OK]

Common Mistakes:

• Using fs.readFile which throws error if file missing
• Trying fs.writeFile which creates or overwrites file
• Using fs.open without error handling

2. Which of the following is the correct syntax to get file stats synchronously in Node.js?

easy

A. fs.statSync('file.txt')

B. fs.stat('file.txt')

C. fs.getStatsSync('file.txt')

D. fs.fileStats('file.txt')

Solution

1. Step 1: Identify synchronous stat method

   fs.statSync is the synchronous method to get file stats.

2. Step 2: Check other options

   fs.stat is asynchronous, others are invalid method names.

3. Final Answer:

   fs.statSync('file.txt') -> Option A

4. Quick Check:

   Synchronous file stats = fs.statSync [OK]

Hint: Sync methods end with Sync, like fs.statSync [OK]

Common Mistakes:

• Confusing async fs.stat with sync fs.statSync
• Using non-existent methods like fs.getStatsSync
• Missing parentheses for function call

3. What will the following code output if 'example.txt' exists and is a file of size 1024 bytes?

const fs = require('fs');
fs.stat('example.txt', (err, stats) => {
  if (err) return console.error('Error');
  console.log(stats.isFile(), stats.size);
});

medium

A. true 1024

B. false 1024

C. true undefined

D. Error

Solution

1. Step 1: Understand fs.stat callback

   If file exists, err is null and stats object contains file info.

2. Step 2: Check stats properties

   stats.isFile() returns true if it is a file, stats.size returns file size in bytes.

3. Final Answer:

   true 1024 -> Option A

4. Quick Check:

   File exists and is file = true and size = 1024 [OK]

Hint: stats.isFile() true means file exists, size shows bytes [OK]

Common Mistakes:

• Assuming stats.size is undefined
• Confusing isFile() with isDirectory()
• Not handling error callback properly

4. Identify the error in this code snippet that checks if a file exists:

const fs = require('fs');
try {
  fs.access('data.txt');
  console.log('File exists');
} catch (err) {
  console.log('File does not exist');
}

medium

A. fs.access does not check file existence

B. fs.access is asynchronous and needs a callback or promise

C. Try/catch cannot catch errors in Node.js

D. console.log syntax is incorrect

Solution

1. Step 1: Check fs.access usage

   fs.access is asynchronous and requires a callback or promise to handle errors.

2. Step 2: Understand try/catch with async

   Try/catch does not catch errors from async calls without await or callback handling.

3. Final Answer:

   fs.access is asynchronous and needs a callback or promise -> Option B

4. Quick Check:

   Async fs.access needs callback/promise [OK]

Hint: Async functions need callbacks or await, not try/catch alone [OK]

Common Mistakes:

• Assuming try/catch works with async without await
• Ignoring callback parameter in fs.access
• Thinking fs.access does not check existence

5. You want to write a function that returns true if a given path is a directory and exists, false otherwise. Which code snippet correctly implements this using Node.js synchronous methods?

hard

A. function isDirectory(path) {
if (fs.statSync(path).isDirectory()) return true;
else return false;
}

B. function isDirectory(path) {
return fs.accessSync(path) && fs.statSync(path).isDirectory();
}

C. function isDirectory(path) {
try {
return fs.statSync(path).isDirectory();
} catch {
return false;
}
}

D. function isDirectory(path) {
try {
return fs.existsSync(path) && fs.statSync(path).isFile();
} catch {
return false;
}
}

Solution

1. Step 1: Check for existence and directory type safely

   Using fs.statSync inside try/catch handles missing path errors and checks if it's a directory.

2. Step 2: Analyze other options

   function isDirectory(path) { return fs.accessSync(path) && fs.statSync(path).isDirectory(); } misuses fs.accessSync without error handling; function isDirectory(path) { try { return fs.existsSync(path) && fs.statSync(path).isFile(); } catch { return false; } } checks isFile() instead of isDirectory(); function isDirectory(path) { if (fs.statSync(path).isDirectory()) return true; else return false; } lacks error handling for missing path.

3. Final Answer:

   function isDirectory(path) { try { return fs.statSync(path).isDirectory(); } catch { return false; } } -> Option C

4. Quick Check:

   Try/catch with statSync and isDirectory() = correct [OK]

Hint: Use try/catch with fs.statSync and isDirectory() to check safely [OK]

Common Mistakes:

• Not handling errors for missing paths
• Checking isFile() instead of isDirectory()
• Using fs.accessSync without try/catch