pathe

What is pathe?

The 'pathe' npm package is a utility library for handling and manipulating file paths in Node.js. It provides a variety of functions to work with file paths in a more convenient and readable way.

What are pathe's main functionalities?

Join Paths

The 'join' function concatenates multiple path segments into a single path, normalizing the resulting path.

const { join } = require('pathe');
const fullPath = join('/foo', 'bar', 'baz/asdf', 'quux', '..');
console.log(fullPath); // '/foo/bar/baz/asdf'

Resolve Paths

The 'resolve' function resolves a sequence of paths or path segments into an absolute path.

const { resolve } = require('pathe');
const resolvedPath = resolve('foo/bar', '/tmp/file/', '..', 'a/../subfile');
console.log(resolvedPath); // '/tmp/subfile'

Normalize Paths

The 'normalize' function normalizes the given path, resolving '..' and '.' segments.

const { normalize } = require('pathe');
const normalizedPath = normalize('/foo/bar//baz/asdf/quux/..');
console.log(normalizedPath); // '/foo/bar/baz/asdf'

Get Directory Name

The 'dirname' function returns the directory name of a path.

const { dirname } = require('pathe');
const dirName = dirname('/foo/bar/baz/asdf/quux');
console.log(dirName); // '/foo/bar/baz/asdf'

Get Base Name

The 'basename' function returns the last portion of a path, typically the file name.

const { basename } = require('pathe');
const baseName = basename('/foo/bar/baz/asdf/quux.html');
console.log(baseName); // 'quux.html'

Get Extension Name

The 'extname' function returns the extension of the path, from the last occurrence of the '.' character to end of string in the last portion of the path.

const { extname } = require('pathe');
const extName = extname('index.html');
console.log(extName); // '.html'

Other packages similar to pathe

path

The 'path' module is a built-in Node.js module that provides utilities for working with file and directory paths. It offers similar functionalities to 'pathe' such as joining, resolving, normalizing paths, and extracting directory names, base names, and extensions. 'pathe' can be seen as an enhanced version of the 'path' module with additional features and improvements.

upath

The 'upath' package is a utility for working with file paths across different operating systems. It ensures consistent path handling regardless of the platform. 'upath' offers similar functionalities to 'pathe' but focuses more on cross-platform compatibility.

path-to-regexp

The 'path-to-regexp' package is used to convert paths to regular expressions, which can be useful for routing and matching URL patterns. While it provides some path manipulation capabilities, its primary focus is on pattern matching, making it somewhat different from 'pathe'.

README

pathe

Normalized paths for Node.js

🧪 This package is still experimental and might not handle all cases. Please track issues.

❓ Why

For historical reasons, windows followed MSDos and using backslash \\ for seperating paths rather than slash /. While modern versions of Windows as well as Node.js on Windows, support slash nowadays!

Node.js's built in path module in the default operation of the path module varies based on the operating system on which a Node.js application is running. Specifically, when running on a Windows operating system, the path module will assume that Windows-style paths are being used.

This makes lots of trouble of different code behavior between Windows and Posix and it makes problems with different behaviors.

This package is a replacement based on built in path module and always ensures path are normalized with slash /.

Compared to popular upath, this package tries to privide identical exports of Node.js with normalization on all operations and written in modern ESM/Typescript (upath is written with coffeescript and is not supporting native esm exports).

💿 Install

Install using npm or yarn:

npm i pathe
# or
yarn add pathe

Import:

// ESM / Typescript
import { resolve } from 'pathe'

// CommonJS
const { resolve } = require('pathe')

License

MIT