[node.js] node:path

path module

path 모듈은 파일과 디렉터리 경로 작업을 위한 유틸리티를 제공합니다.

 

path 모듈은 node.js가 실행되는 운영체제에 따라 기본 동작이 달라집니다.

예를 들어, Windows 운영체제에서 path 모듈은 Windows 스타일 경로가 사용되고 있다고 가정합니다.

 

따라서 path.basename()의 실행 결과는 POSIX와 WIndows에서 다르게 나타납니다.

POSIX

path.basename('C:\\temp\\myfile.html');
// Returns: 'C:\\temp\\myfile.html'

Windows

path.basename('C:\\temp\\myfile.html');
// Returns: 'myfile.html'

 

모든 운영 체제에서 Windows 파일 경로를 사용할 때 일관된 결과를 얻으려면 path.win32를 사욥하면 됩니다.

path.win32.basename('C:\\temp\\myfile.html');
// Returns: 'myfile.html'

 

 

모든 운영 체제에서 POSIX 파일 경로를 사용할 때 일관된 결과를 얻으려면 path.posix를 사용하면 됩니다.

path.posix.basename('/tmp/myfile.html');
// Returns: 'myfile.html'

 

메서드

path.basename(path[, suffix])

path의 마지막 부분을 반환합니다.

path.basename('/foo/bar/baz/asdf/quux.html');
// Returns: 'quux.html'

 

suffix로 확장자를 주면 확장자를 제외한 부분만 반환합니다.

path.basename('/foo/bar/baz/asdf/quux.html', '.html');
// Returns: 'quux'

 

path.dirname(path)

path의 디렉터리를 반환합니다.

path.dirname('/foo/bar/baz/asdf/quux');
// Returns: '/foo/bar/baz/asdf'

 

path.extname(path)

path의 확장자를 가져옵니다.

마지막으로 나타난 '.'을 기준으로 가져옵니다.

path.extname('index.html');
// Returns: '.html'

path.extname('index.coffee.md');
// Returns: '.md'

path.extname('index.');
// Returns: '.'

path.extname('index');
// Returns: ''

path.extname('.index');
// Returns: ''

path.extname('.index.md');
// Returns: '.md'

path.format(pathObject)

pathObject로부터 pathString을 생성합니다. 

path.parse()와 반대의 동작을 수행합니다.

- dir : string
- root : string
- base : string
- name : string
- ext : string

// If `dir`, `root` and `base` are provided,
// `${dir}${path.sep}${base}`
// will be returned. `root` is ignored.
path.format({
  root: '/ignored',
  dir: '/home/user/dir',
  base: 'file.txt',
});
// Returns: '/home/user/dir/file.txt'

 

path.matchesGlob(path, pattern)

path가 pattern과 일치하는지 확인합니다.

path.matchesGlob('/foo/bar', '/foo/*'); // true
path.matchesGlob('/foo/bar*', 'foo/bird'); // false

 

path.isAbsolute(path)

path가 절대 경로인지 확인합니다.

path.isAbsolute('/foo/bar');   // true
path.isAbsolute('/baz/..');    // true
path.isAbsolute('/baz/../..'); // true
path.isAbsolute('qux/');       // false
path.isAbsolute('.');          // false

 

path.join([...paths])

플랫폼별(Windows, POSIX) 구분자를 사용하여 주어진 모든 경로 segment를 연결한 후, 절대 경로를 반환합니다.

길이가 0인 경로 segment를 넣으면 무시되고 '.'을 반환합니다.

path.join('/foo', 'bar', 'baz/asdf', 'quux', '..');
// Returns: '/foo/bar/baz/asdf'

path.join('foo', {}, 'bar');
// Throws 'TypeError: Path must be a string. Received {}'

 

path.normalize(path)

'..'과 '.'등 주어진 경로를 정규화합니다.

path.normalize('/foo/bar//baz/asdf/quux/..');
// Returns: '/foo/bar/baz/asdf'

 

path.parse(path)

path를 파싱 하여 다음 프로퍼티를 가지고 있는 object를 생성합니다.

- dir : string
- root : string
- base : string
- name : string
- ext : string

path.parse('/home/user/dir/file.txt');
// Returns:
// { root: '/',
//   dir: '/home/user/dir',
//   base: 'file.txt',
//   ext: '.txt',
//   name: 'file' }

 

path.relative(from, to)

current working directory를 기준으로 from에서 to로 가는 상대경로를 반환합니다.

from과 to가 같은 경우, 길이가 0인 문자열을 반환합니다.

path.relative('/data/orandea/test/aaa', '/data/orandea/impl/bbb');
// Returns: '../../impl/bbb'

 

path.resolve([...paths])

일련의 path를 절대 경로로 변환합니다.

 

오른쪽에서 왼쪽처리하며 , 절대 경로가 생성될 때까지 path를 계속 붙입니다.

예를 들어, 경로 세그먼트 시퀀스: /foo, /bar, baz가 주어졌을 때, path.resolve('/foo', '/bar', 'baz')를 호출하면 /bar/baz를 반환합니다. 'baz'는 절대 경로가 아니지만 '/bar' + '/' + 'baz'는 절대 경로이기 때문입니다.

 

만약 절대 경로를 만들 수 없으면 current working directory의 path를 반환합니다.

path.resolve('/foo/bar', './baz');
// Returns: '/foo/bar/baz'

path.resolve('/foo/bar', '/tmp/file/');
// Returns: '/tmp/file'

path.resolve('wwwroot', 'static_files/png/', '../gif/image.gif');
// If the current working directory is /home/myself/node,
// this returns '/home/myself/node/wwwroot/static_files/gif/image.gif'

 

프로퍼티

path.delimiter

플랫폼별 경로 구분자를 제공합니다.

• ; for Windows
• : for POSIX

POSIX

console.log(process.env.PATH);
// Prints: '/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin'

process.env.PATH.split(path.delimiter);
// Returns: ['/usr/bin', '/bin', '/usr/sbin', '/sbin', '/usr/local/bin']

 

Windows

console.log(process.env.PATH);
// Prints: 'C:\Windows\system32;C:\Windows;C:\Program Files\node\'

process.env.PATH.split(path.delimiter);
// Returns ['C:\\Windows\\system32', 'C:\\Windows', 'C:\\Program Files\\node\\']

 

path.posix

path 메서드의 POSIX 특정 구현에 대한 접근을 제공합니다.

path.sep

플랫폼별 경로 세그먼트 구분자를 제공합니다:

 

path.win32

path 메서드의 Windows 전용 구현체에 대한 접근을 제공합니다.

참고자료

https://nodejs.org/api/path.html#pathdelimiter

Path | Node.js v25.2.1 Documentation