دستور path.basename در Node.js با توجه به اینکه Node.js یکی از محبوب‌ترین پلتفرم‌های برنامه‌نویسی جاوااسکریپت است، آشنایی با دستورات مختلف آن برای توسعه‌دهندگان بسیار حائز اهمیت است. یکی از این دستورات که در این مقاله به آن پرداخته می‌شود، دستور path.basename است. این دستور برای بازگرداندن نام فایل از یک مسیر کامل استفاده می‌شود. با استفاده از دستور path.basename می‌توان نام فایل را از یک مسیر کامل استخراج کرد. این دستور خروجی رشته‌ای را به ما می‌دهد که نام فایل را حاوی می‌باشد. در صورتی که مسیر خالی باشد، نام فایل آخرین بخش می‌باشد. برای استفاده از این دستور در Node.js، ابتدا باید ماژول path را وارد کنیم. سپس با فراخوانی تابع basename از این ماژول و به عنوان ورودی دادن مسیر کامل، نام فایل را دریافت می‌کنیم. در نهایت، نام فایل را می‌توانیم به عنوان خروجی استفاده کنیم. حال که با دستور path.basename در Node.js آشنا شدیم، می‌توانیم به طور کامل بررسی کنیم که چگونه از این دستور استفاده کنیم و چه پارامتر‌هایی را می‌توانیم به آن ارسال کنیم. در ادامه، به بررسی این موضوع خواهیم پرداخت. ## مرحله اول: نصب Node.js قبل از شروع استفاده از دستور path.basename در Node.js، باید اطمینان حاصل کنیم که Node.js بر روی سیستم ما نصب شده است. در صورتی که Node.js را نصب نکرده‌اید، می‌توانید طبق دستورالعمل‌های رسمی Node.js آن را نصب کنید. ## مرحله دوم: وارد کردن ماژول path برای استفاده از دستور path.basename در Node.js، ابتدا باید ماژول path را وارد کنیم. برای این کار می‌توانیم از دستور زیر استفاده کنیم: ```javascript const path = require('path'); ``` این دستور به ما امکان استفاده از توابع مربوط به ماژول path را می‌دهد. ## مرحله سوم: استفاده از دستور path.basename بعد از وارد کردن ماژول path، می‌توانیم از دستور path.basename برای استخراج نام فایل از مسیر کامل استفاده کنیم. برای استفاده از این دستور، می‌توانیم از قالب زیر استفاده کنیم: ```javascript const path = require('path'); const filePath = '/path/to/file.txt'; const fileName = path.basename(filePath); console.log(fileName); // Output: file.txt ``` در این مثال، مسیر کامل فایل را به عنوان ورودی به تابع basename می‌دهیم و نام فایل را دریافت می‌کنیم. سپس نام فایل را به عنوان خروجی نمایش می‌دهیم. ## دستور path.basename در Node.js و پارامتر‌ها در دستور path.basename در Node.js می‌توانیم از پارامتر‌های مختلفی استفاده کنیم تا عملکرد این دستور را تغییر دهیم. در ادامه به بررسی این پارامتر‌ها خواهیم پرداخت: ### پارامتر dir این پارامتر به ما امکان می‌دهد که مسیری را به عنوان ورودی بدهیم تا نام فایل را از آن استخراج کند. به طور پیش‌فرض، این پارامتر خالی است و مقدار آن را در صورت لزوم می‌توان تنظیم کرد. ### پارامتر ext با استفاده از این پارامتر، می‌توانیم پسوند فایل را از نام فایل حذف کنیم. این پارامتر اختیاری است و در صورت استفاده از آن، تنها نام فایل بدون پسوند به ما برگردانده می‌شود. ### پارامتر includeExtension با استفاده از این پارامتر، می‌توانیم پسوند فایل را همراه با نام فایل برگردانده کنیم. این پارامتر اختیاری است و اگر آن را true قرار دهیم، نام فایل همراه با پسوند به ما برگردانده می‌شود. ## دستور path.basename در Node.js و مثال‌های کاربردی در این بخش، به بررسی چند مثال کاربردی از دستور path.basename در Node.js خواهیم پرداخت: ### مثال ۱: استخراج نام فایل از مسیر کامل ```javascript const path = require('path'); const filePath = '/path/to/file.txt'; const fileName = path.basename(filePath); console.log(fileName); // Output: file.txt ``` در این مثال، با استفاده از دستور path.basename می‌توانیم نام فایل را از یک مسیر کامل استخراج کنیم. ### مثال ۲: استخراج نام فایل بدون پسوند ```javascript const path = require('path'); const filePath = '/path/to/file.txt'; const fileNameWithoutExtension = path.basename(filePath, '.txt'); console.log(fileNameWithoutExtension); // Output: file ``` در این مثال، با استفاده از پارامتر ext می‌توانیم پسوند فایل را حذف کنیم و نام فایل بدون پسوند را دریافت کنیم. ### مثال ۳: بازگرداندن نام فایل همراه با پسوند ```javascript const path = require('path'); const filePath = '/path/to/file.txt'; const fileNameWithExtension = path.basename(filePath, null, true); console.log(fileNameWithExtension); // Output: file.txt ``` در این مثال، با استفاده از پارامتر includeExtension می‌توانیم نام فایل همراه با پسوند را دریافت کنیم. ## پرسش‌های متداول ### چگونه می‌توانیم نام فایل را از مسیر کامل استخراج کنیم؟ برای استخراج نام فایل از مسیر کامل در Node.js، می‌توانیم از دستور path.basename استفاده کنیم. این دستور خروجی رشته‌ای حاوی نام فایل را به ما می‌دهد. ### آیا دستور path.basename پارامتر‌هایی دارد؟ بله، دستور path.basename در Node.js دارای سه پارامتر است. این پارامتر‌ها شامل dir، ext و includeExtension می‌باشند. ### چگونه می‌توانیم پسوند فایل را از نام فایل حذف کنیم؟ با استفاده از پارامتر ext در دستور path.basename می‌توانیم پسوند فایل را از نام فایل حذف کنیم. در صورت استفاده از این پارامتر، تنها نام فایل بدون پسوند به ما برگردانده می‌شود. ### آیا می‌توانیم نام فایل همراه با پسوند را دریافت کنیم؟ بله، با استفاده از پارامتر includeExtension در دستور path.basename می‌توانیم نام فایل همراه با پسوند را دریافت کنیم. ### دستور path.basename در Node.js در چه شرایطی خطا می‌دهد؟ دستور path.basename در Node.js خطا می‌دهد اگر ورودی آن یک مسیر خالی باشد. ### آیا دستور path.basename حساس به بزرگی و کوچکی حروف است؟ بله، دستور path.basename حساس به بزرگی و کوچکی حروف است. بنابراین، جزئیات تطابق حروف را باید به دقت رعایت کنید. ## نتیجه‌گیری در این مقاله، به بررسی دستور path.basename در Node.js پرداختیم. این دستور برای استخراج نام فایل از یک مسیر کامل استفاده می‌شود. با استفاده از ماژول path و فراخوانی تابع basename، می‌توانیم از این دستور استفاده کنیم. همچنین، با استفاده از پارامتر‌های مختلف می‌توانیم عملکرد این دستور را تغییر دهیم و نام فایل را به صورت دلخواه استخراج کنیم. امیدواریم که این مقاله به شما کمک