| title | The Node.js path module |
|---|---|
| description | The path module of Node.js provides useful functions to interact with file paths |
| authors | flaviocopes, MylesBorins, fhemberger, LaRuaNa, amiller-gh, ahmadawais, 19shubham11 |
| section | Getting Started |
The path module provides a lot of very useful functionality to access and interact with the file system.
There is no need to install it. Being part of the Node.js core, it can be used by simply requiring it:
const path = require('path')This module provides path.sep which provides the path segment separator (\ on Windows, and / on Linux / macOS), and path.delimiter which provides the path delimiter (; on Windows, and : on Linux / macOS).
These are the path methods:
Return the last portion of a path. A second parameter can filter out the file extension:
require('path').basename('/test/something') //something
require('path').basename('/test/something.txt') //something.txt
require('path').basename('/test/something.txt', '.txt') //somethingReturn the directory part of a path:
require('path').dirname('/test/something') // /test
require('path').dirname('/test/something/file.txt') // /test/somethingReturn the extension part of a path
require('path').extname('/test/something') // ''
require('path').extname('/test/something/file.txt') // '.txt'Returns true if it's an absolute path
require('path').isAbsolute('/test/something') // true
require('path').isAbsolute('./test/something') // falseJoins two or more parts of a path:
const name = 'joe'
require('path').join('/', 'users', name, 'notes.txt') //'/users/joe/notes.txt'Tries to calculate the actual path when it contains relative specifiers like . or .., or double slashes:
require('path').normalize('/users/joe/..//test.txt') //'/users/test.txt'Parses a path to an object with the segments that compose it:
root: the rootdir: the folder path starting from the rootbase: the file name + extensionname: the file nameext: the file extension
Example:
require('path').parse('/users/test.txt')results in
{
root: '/',
dir: '/users',
base: 'test.txt',
ext: '.txt',
name: 'test'
}Accepts 2 paths as arguments. Returns the the relative path from the first path to the second, based on the current working directory.
Example:
require('path').relative('/Users/joe', '/Users/joe/test.txt') //'test.txt'
require('path').relative('/Users/joe', '/Users/joe/something/test.txt') //'something/test.txt'You can get the absolute path calculation of a relative path using path.resolve():
path.resolve('joe.txt') //'/Users/joe/joe.txt' if run from my home folderBy specifying a second parameter, resolve will use the first as a base for the second:
path.resolve('tmp', 'joe.txt') //'/Users/joe/tmp/joe.txt' if run from my home folderIf the first parameter starts with a slash, that means it's an absolute path:
path.resolve('/etc', 'joe.txt') //'/etc/joe.txt'