ماژول Path در Node.js

ماژول node:path مجموعه‌ای از ابزارها برای کار با مسیرهای فایل و پوشه فراهم می‌کند. این ماژول امکان تجزیه، ترکیب، نرمال‌سازی، و بررسی مسیرها را به‌صورت سازگار با سیستم‌عامل‌های مختلف (Windows و POSIX) می‌دهد. همچنین نسخه‌های اختصاصی path.win32 و path.posix برای نتایج یکسان در هر سیستم‌عامل ارائه شده‌اند.

path.basename / path.dirname / path.extnamepath.format / path.parsepath.join / path.normalize / path.resolvepath.isAbsolute / path.relativepath.delimiter / path.seppath.win32 / path.posix

~2 min read · Updated Dec 30, 2025

1. تفاوت Windows و POSIX


رفتار پیش‌فرض path بسته به سیستم‌عامل متفاوت است. برای نتایج یکسان:


  • path.win32: برای مسیرهای ویندوز.
  • path.posix: برای مسیرهای POSIX.

2. متدهای پایه


  • path.basename(path[, suffix]): آخرین بخش مسیر (نام فایل).
  • path.dirname(path): نام پوشهٔ والد.
  • path.extname(path): پسوند فایل.

path.basename('/foo/bar/file.txt'); // 'file.txt'
path.dirname('/foo/bar/file.txt');  // '/foo/bar'
path.extname('index.html');         // '.html'

3. ساخت و تجزیه مسیر


  • path.format(pathObject): ساخت مسیر از یک شیء.
  • path.parse(path): تجزیه مسیر به root, dir, base, name, ext.

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

4. ترکیب و نرمال‌سازی


  • path.join([...paths]): ترکیب بخش‌های مسیر.
  • path.normalize(path): نرمال‌سازی مسیر (حذف .. و .).
  • path.resolve([...paths]): ساخت مسیر مطلق.

path.join('/foo', 'bar', 'baz'); // '/foo/bar/baz'
path.normalize('/foo/bar//baz/..'); // '/foo/bar'
path.resolve('www', 'static/img');  // '/home/user/www/static/img'

5. بررسی مسیر


  • path.isAbsolute(path): بررسی مطلق بودن مسیر.
  • path.relative(from, to): مسیر نسبی بین دو مسیر.

path.isAbsolute('/foo/bar'); // true
path.relative('/data/test', '/data/impl'); // '../impl'

6. ثابت‌های سیستم‌عامل


  • path.delimiter: جداکنندهٔ مسیرها در متغیر PATH (: در POSIX، ; در ویندوز).
  • path.sep: جداکنندهٔ بخش‌های مسیر (/ در POSIX، \ در ویندوز).

7. ویژگی‌های خاص ویندوز


  • path.toNamespacedPath(path): تبدیل مسیر به namespace-prefixed (فقط ویندوز).
  • path.win32: نسخهٔ ویندوزی متدها.

نتیجه‌گیری


ماژول path در Node.js ابزارهای قدرتمندی برای مدیریت مسیرها در سیستم‌عامل‌های مختلف فراهم می‌کند. با استفاده از متدهای آن می‌توان مسیرها را تجزیه، ترکیب، نرمال‌سازی و بررسی کرد، و برنامه‌ها را مستقل از پلتفرم توسعه داد.


Written & researched by Dr. Shahin Siami

Related Articles

آشنایی کامل با ماژول Cluster در Node.js و نحوه افزایش مقیاس‌پذیری سرور

ماژول Cluster در Node.js به توسعه‌دهندگان اجازه می‌دهد چندین پردازش همزمان ایجاد کنند که یک پورت سرور را به اشتراک می‌گذارند. این کار باعث استفاده بهتر از هسته‌های CPU و افزایش توان پردازش برنامه می‌شود. در این مقاله نحوه کار Cluster، مدیریت Workerها، تنظیمات مهم و مثال عملی را بررسی می‌کنیم.

Continue

راهنمای جامع ماژول VM در Node.js (ماژول node:vm)

ماژول node:vm امکان کامپایل و اجرای کد جاوااسکریپت در کانتکست‌های ایزولهٔ V8 را فراهم می‌کند. این کانتکست‌ها مانند یک «سندباکس سبک» داخل برنامهٔ Node.js عمل می‌کنند و هرکدام globalThis مخصوص خود را دارند. این ماژول برای اجرای پویا، موتورهای قالب (Template Engines)، سیستم‌های افزونه (Plugin Systems)، REPLها و تست ایزولهٔ منطق بسیار مناسب است. اما نکتهٔ بسیار مهم: vm یک ابزار امنیتی نیست و نباید برای اجرای کدهای غیرقابل‌اعتماد استفاده شود.

Continue

راهنمای جامع ماژول V8 در Node.js (ماژول node:v8)

راهنمای جامع ماژول V8 در Node.js (ماژول node:v8)

Continue

راهنمای جامع Worker Threads در Node.js (ماژول node:worker_threads)

ماژول node:worker_threads امکان اجرای واقعی چندریسمانی (Multithreading) را در Node.js فراهم می‌کند. برخلاف مدل تک‌ریسمانی سنتی Node.js، Worker Threads اجازه می‌دهند کارهای سنگین CPU در ریسه‌های جداگانه اجرا شوند بدون اینکه حلقهٔ رویداد (Event Loop) مسدود شود. این ماژول از حافظهٔ اشتراکی، انتقال بدون کپی (Zero‑Copy)، کانال‌های پیام، Worker Pool، محدودیت منابع و ابزارهای همگام‌سازی پیشرفته پشتیبانی می‌کند. Worker Threads برای پردازش‌های محاسباتی سنگین ایده‌آل هستند، در حالی که I/O همچنان باید توسط ریسهٔ اصلی مدیریت شود.

Continue

راهنمای جامع ماژول util در Node.js

ماژول node:util مجموعه‌ای از توابع کمکی قدرتمند برای استفاده در هستهٔ Node.js و همچنین توسعهٔ برنامه‌ها ارائه می‌دهد. این ماژول ابزارهایی برای دیباگ، بازرسی اشیا، تبدیل Callback ↔ Promise، قالب‌بندی رشته‌ها، بررسی انواع، مدیریت خطاها، رمزگذاری متن، پردازش MIME، پارس آرگومان‌های CLI، سیگنال‌های Abort، و ابزارهای متفرقه فراهم می‌کند. این ماژول یکی از جعبه‌ابزارهای اصلی و ضروری برای توسعه‌دهندگان Node.js است.

Continue

راهنمای جامع ماژول URL در Node.js

ماژول node:url ابزارهایی برای تحلیل، ساخت، و دست‌کاری URLها در Node.js فراهم می‌کند. Node.js دو API برای کار با URL دارد: WHATWG URL API — استاندارد مدرن و سازگار با مرورگرها (توصیه‌شده). Legacy API — API قدیمی Node.js (غیرتوصیه‌شده). WHATWG URL API یک رابط تمیز، سازگار و قدرتمند برای کار با اجزای URL، پارامترهای query، الگوهای URL و حتی Blob URLها ارائه می‌دهد.

Continue