npm · #1777 most downloaded on npm

upath

3.0.894M downloads/moanodynos/upath ↗New releases in your daily digest, changelog included.

A drop-in replacement / proxy to Node.js path, replacing \\ with / for all results & adding file extension functions.

Release timeline

25 releases since 2014

20142016201820202022

3.0.85 Jul 2026
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> GitOrigin-RevId: daf4d21a564224cb008ed7e04ba4fd08d859ecc8
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
GitOrigin-RevId: daf4d21a564224cb008ed7e04ba4fd08d859ecc8
Open source →
Additional notes2 sources agree
Patch Changes

bb7e074: Fix normalizeTrim to preserve the //./ DOS-device/UNC root so it stays idempotent — normalizeTrim('//.//') now returns '//./' instead of the invalid '//.'. Thanks to @spokodev for the fix.
Open source →
3.0.720 Apr 2026
ci: add changesets publish workflow
ci: add changesets publish workflow
Open source →

Additional notes2 sources agree

7f1590a: Fix @types/node >= 25 compatibility. PlatformPath was removed from @types/node v25; upath now derives its PlatformPath type from typeof path instead of re-exporting the removed interface. Works with @types/node v20 through v25+.

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

3.0.69 Apr 2026

ci: restore publish.yml — public-repo-only, excluded from Copybara sync

Additional notes2 sources agree

Polar.sh funding -- added to .github/FUNDING.yml and package.json alongside existing GitHub Sponsors and Tidelift.
"Who Uses upath" section in README -- trust signals with notable dependents (Chokidar, Nuxt, 1,300+ npm packages).
Architecture section in README -- explains the dynamic proxy pattern and how upath stays in sync with Node.js.

README revamped -- pain-first API docs showing path vs upath behavior side-by-side, inspired by the v2-era docs. Every extra function now explains why it exists (what path does wrong).
Deterministic docs/API.md generation -- test files are now sorted by name before the doc reporter processes them, eliminating spurious diffs caused by Jest's non-deterministic parallel execution order.

Pre-commit hook now works in git worktrees without node_modules -- the hook falls back to the main worktree's node_modules/.bin when lint-staged isn't found locally.

3.0.05 Apr 2026

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

Additional notes2 sources agree

Node >= 20 required — dropped support for Node 4–18. Update your CI matrix and engines field.
CJS exports now include __esModule and default properties — require('upath') still works for all standard usage (no .default needed). However, Object.keys(require('upath')) now includes "__esModule" and "default". Bundlers using Babel-style interop (mod.__esModule ? mod.default : mod) will resolve to .default, which IS the full upath object, so it works correctly.
TypeScript type params narrowed — join(...paths: any[]) → join(...paths: string[]), same for resolve and joinSafe. If you pass non-string args, add explicit casts: join(myVar as string).
_makeLong removed from top-level exports — this was a deprecated Node.js internal. Use toNamespacedPath instead (available in upath v2+ and Node.js 8.3+). Note: _makeLong remains accessible via the .default property on CJS exports (it's part of the full path proxy), but this is not a supported API.
Boxed String objects no longer accepted — new String('foo') is rejected; use plain string primitives. This is unlikely to affect anyone.

TypeScript rewrite — full type safety, source-of-truth types shipped with the package.
Dual CJS/ESM — import and require() both work via package.json exports.
Named ESM imports — import { normalize, join, toUnix } from 'upath'.
matchesGlob typed export (wraps Node 22+ path.matchesGlob).
toNamespacedPath typed export.
UPath interface exported for TypeScript consumers.
Auto-generated API docs — docs/API.md built from test suite.