process.cwd and __dirname in Node.js - Mini Project: Build & Apply

Understanding process.cwd() and __dirname in Node.js

📖 Scenario: You are creating a simple Node.js script that needs to work with file paths. To do this correctly, you must understand how to get the current working directory and the directory of the script file itself.

🎯 Goal: Build a Node.js script that shows the difference between process.cwd() and __dirname by storing their values in variables and then using them.

📋 What You'll Learn

Create a variable called currentWorkingDir that stores the value of process.cwd().

Create a variable called scriptDir that stores the value of __dirname.

Write a function called showDirectories that returns an object with currentWorkingDir and scriptDir as properties.

Export the showDirectories function using module.exports.

💡 Why This Matters

🌍 Real World

When working with files in Node.js, knowing the current working directory and the script's directory helps you build correct file paths. This avoids errors when your program runs from different folders.

💼 Career

Many Node.js jobs require handling file paths correctly. Understanding process.cwd() and __dirname is essential for writing reliable server scripts, build tools, and CLI applications.

1

Create variables for directories

Create a variable called currentWorkingDir and set it to process.cwd(). Then create a variable called scriptDir and set it to __dirname.

Node.js

// Create variables currentWorkingDir and scriptDir
// Your code here

Hint

Use const to create variables. process.cwd() gives the current working directory. __dirname gives the directory of the current script.

2

Create a function to return directories

Create a function called showDirectories that returns an object with properties currentWorkingDir and scriptDir using the variables you created.

Node.js

const currentWorkingDir = process.cwd();
const scriptDir = __dirname;

// Create function showDirectories
// Your code here

Hint

Define a function with function showDirectories(). Return an object with the two variables as properties.

3

Export the function

Export the showDirectories function using module.exports so other files can use it.

Node.js

const currentWorkingDir = process.cwd();
const scriptDir = __dirname;

function showDirectories() {
    return { currentWorkingDir, scriptDir };
}

// Export showDirectories function
// Your code here

Hint

Use module.exports = { showDirectories } to export the function.

4

Add a comment explaining the difference

Add a comment at the top of the file explaining in simple words the difference between process.cwd() and __dirname.

Node.js

// Add a comment explaining the difference between process.cwd() and __dirname
const currentWorkingDir = process.cwd();
const scriptDir = __dirname;

function showDirectories() {
    return { currentWorkingDir, scriptDir };
}

module.exports = { showDirectories };

Hint

Write two simple comments starting with // explaining each one in a friendly way.

Practice

1. What does process.cwd() return in a Node.js program?

easy

A. The folder where the current script file is located

B. The folder where you started the Node.js program

C. The full path of the current script file

D. The user's home directory

Solution

1. Step 1: Understand process.cwd() purpose

   process.cwd() returns the current working directory where the Node.js process was started, not the script location.

2. Step 2: Compare with __dirname

   __dirname gives the script's folder, which is different from the working directory if you run the script from another folder.

3. Final Answer:

   The folder where you started the Node.js program -> Option B

4. Quick Check:

   process.cwd() = start folder [OK]

Hint: Remember: cwd = where you run node from [OK]

Common Mistakes:

• Confusing process.cwd() with __dirname
• Thinking it returns the script file path
• Assuming it returns the user's home directory

2. Which of the following is the correct way to get the directory name of the current script file in Node.js?

easy

A. __dirname

B. process.dirName

C. process.cwd()

D. currentDir()

Solution

1. Step 1: Identify the built-in variable for script folder

   __dirname is a Node.js global variable that holds the directory path of the current script file.

2. Step 2: Check other options for validity

   process.cwd() returns the working directory, not script folder. The others are not valid Node.js properties or functions.

3. Final Answer:

   __dirname -> Option A

4. Quick Check:

   __dirname = script folder [OK]

Hint: Use __dirname for script folder path [OK]

Common Mistakes:

• Using process.cwd() instead of __dirname
• Trying to use non-existent properties like process.dirName
• Confusing function names

3. Consider this code run from folder /home/user/projects with script located at /home/user/projects/app/server.js:

console.log(process.cwd());
console.log(__dirname);

What will be the output?

medium

A. /home/user/projects
/home/user/projects/app

B. /home/user/projects/app
/home/user/projects/app

C. /home/user/projects/app
/home/user/projects

D. /home/user/projects
/home/user/projects

Solution

1. Step 1: Understand process.cwd() output

   Since the program is started in /home/user/projects, process.cwd() returns this folder.

2. Step 2: Understand __dirname output

   The script is located in /home/user/projects/app/server.js, so __dirname returns /home/user/projects/app.

3. Final Answer:

   /home/user/projects /home/user/projects/app -> Option A

4. Quick Check:

   cwd = start folder, __dirname = script folder [OK]

Hint: cwd = run folder, __dirname = script folder [OK]

Common Mistakes:

• Swapping outputs of process.cwd() and __dirname
• Assuming both return the same path
• Ignoring where the script file is located

4. You wrote this code in /app/index.js and ran it from /app folder:

console.log(process.dirName);

What will happen when you run this script?

medium

A. It prints the current working directory

B. It prints the script's directory

C. It throws a ReferenceError

D. It prints undefined

Solution

1. Step 1: Check the property used

   process.dirName is not a valid property in Node.js. The correct property is __dirname.

2. Step 2: Understand the error caused

   Accessing an undefined property on process does not throw an error, but since process is an object, process.dirName is undefined. However, trying to log undefined prints 'undefined' without error.

3. Step 3: Confirm behavior

   Since process.dirName is undefined, console.log prints 'undefined'. No ReferenceError occurs.

4. Final Answer:

   It prints undefined -> Option D

5. Quick Check:

   Invalid property logs undefined [OK]

Hint: Check exact property names; typos cause undefined [OK]

Common Mistakes:

• Expecting ReferenceError for undefined property
• Confusing __dirname with process.dirName
• Assuming process.dirName exists

5. You want to read a file named config.json located in the same folder as your script /project/src/app.js. You run the script from /project folder. Which code snippet correctly builds the path to config.json to read it safely regardless of where you run the script?

hard

A. const configPath = './config.json';

B. const path = require('path');
const configPath = path.join(process.cwd(), 'config.json');

C. const path = require('path');
const configPath = path.join(__dirname, 'config.json');

D. const configPath = process.cwd() + '/src/config.json';

Solution

1. Step 1: Identify script and file locations

   The script is at /project/src/app.js and config.json is in the same folder /project/src.

2. Step 2: Understand path building with __dirname

   Using __dirname gives the script folder regardless of where you run the script, so joining __dirname with config.json correctly points to the file.

3. Step 3: Analyze other options

   const path = require('path'); const configPath = path.join(process.cwd(), 'config.json'); uses process.cwd() which is /project, so it looks for /project/config.json (wrong folder). const configPath = './config.json'; is relative and depends on run folder, risky. const configPath = process.cwd() + '/src/config.json'; hardcodes path and may break on different OS or run folders.

4. Final Answer:

   const path = require('path'); const configPath = path.join(__dirname, 'config.json'); -> Option C

5. Quick Check:

   Use __dirname to locate files relative to script [OK]

Hint: Use __dirname + path.join for script-relative files [OK]

Common Mistakes:

• Using process.cwd() which depends on run folder
• Using relative paths without __dirname
• Hardcoding paths without path.join