How to Use path.dirname in Node.js: Simple Guide

In Node.js, use path.dirname(path) to get the directory part of a file path as a string. It extracts everything before the last slash, helping you find the folder containing a file.

Syntax

The path.dirname(path) function takes a single argument path, which is a string representing a file or directory path. It returns a string with the directory portion of that path, excluding the file name or last segment.

• path: The full file or directory path as a string.
• Returns: The directory path as a string.

javascript

const path = require('path');

const directory = path.dirname('/home/user/docs/file.txt');
console.log(directory);

Output

/home/user/docs

Example

This example shows how to use path.dirname to get the folder path from a full file path. It prints the directory part to the console.

javascript

import path from 'path';

const filePath = '/Users/alex/projects/app/index.js';
const dirName = path.dirname(filePath);
console.log('Directory:', dirName);

Output

Directory: /Users/alex/projects/app

Common Pitfalls

One common mistake is passing a directory path ending with a slash, which path.dirname treats differently. For example, path.dirname('/folder/subfolder/') returns /folder/subfolder, not /folder. Also, using path.dirname on just a file name without a path returns . meaning current directory.

Always ensure your input path is normalized and absolute if you want consistent results.

javascript

import path from 'path';

// Trailing slash returns the directory itself
console.log(path.dirname('/folder/subfolder/')); // Outputs: /folder/subfolder

// Without trailing slash, returns parent directory
console.log(path.dirname('/folder/subfolder/file.txt')); // Outputs: /folder/subfolder

Output

/folder/subfolder
/folder/subfolder

Quick Reference

Usage	Description
path.dirname('/a/b/c.txt')	Returns '/a/b' - directory of the file
path.dirname('/a/b/')	Returns '/a/b' - directory when trailing slash present
path.dirname('file.txt')	Returns '.' - current directory for filename only
path.dirname('')	Returns '.' - empty path treated as current directory

Key Takeaways

Use path.dirname(path) to get the directory part of a file path string.

Passing a path with a trailing slash returns the directory itself, not the parent directory.

If you pass only a filename, path.dirname returns '.' meaning current directory.

Normalize paths before using path.dirname for consistent results.

Import path module with require('path') or import path from 'path' in Node.js.