دستور fs.stat در Node.js: یک راهنمای کامل برای استفاده از این دستور دستور fs.stat در Node.js یکی از دستورات مهم و پرکاربرد در برنامه‌نویسی Node.js است که به توسعه‌دهندگان امکان می‌دهد اطلاعات مربوط به یک فایل یا دایرکتوری را دریافت کنند. این دستور قابلیت دریافت اطلاعاتی مانند اندازه فایل، نوع فایل، زمان ساخت و تغییرات فایل و ... را داراست. در این مقاله به صورت کامل به بررسی این دستور و نحوه استفاده از آن در برنامه‌نویسی Node.js خواهیم پرداخت. ## فهرست مطالب 1. مقدمه 2. دستور fs.stat در Node.js چیست؟ 3. نحوه استفاده از دستور fs.stat در Node.js 4. پارامترهای ورودی دستور fs.stat 5. خروجی دستور fs.stat 6. مثال‌های کاربردی دستور fs.stat 7. دستور fs.statSync در Node.js 8. نکات مهم در استفاده از دستور fs.stat 9. مقایسه دستور fs.stat با دستورهای مشابه 10. LSI Keyword 1 11. LSI Keyword 2 12. LSI Keyword 3 13. LSI Keyword 4 14. LSI Keyword 5 15. LSI Keyword 6 16. LSI Keyword 7 17. LSI Keyword 8 18. LSI Keyword 9 19. LSI Keyword 10 20. LSI Keyword 11 21. LSI Keyword 12 22. LSI Keyword 13 23. LSI Keyword 14 24. LSI Keyword 15 25. LSI Keyword 16 ## مقدمه در برنامه‌نویسی Node.js، دستور fs.stat به توسعه‌دهندگان امکان می‌دهد تا اطلاعات مربوط به یک فایل یا دایرکتوری را دریافت کنند. این دستور اطلاعاتی مانند اندازه فایل، نوع فایل، زمان ساخت و تغییرات فایل و ... را برای ما بازگردانی می‌کند. با استفاده از این دستور، می‌توانیم برنامه‌هایی با قابلیت‌های پیشرفته‌تری بسازیم که نیازمند دسترسی به اطلاعات دقیق فایل‌ها و دایرکتوری‌ها هستند. ## دستور fs.stat در Node.js چیست؟ دستور fs.stat در Node.js یکی از دستورات مهم و پرکاربرد است که توسط ماژول fs در این زبان قابل استفاده است. با استفاده از این دستور، می‌توانیم اطلاعات مربوط به یک فایل یا دایرکتوری را دریافت کنیم. این دستور یک تابع نیست بلکه یک متد از ماژول fs است که توسط تمامی اشیاءی که از این ماژول ایجاد می‌شوند قابل استفاده است. ## نحوه استفاده از دستور fs.stat در Node.js برای استفاده از دستور fs.stat در Node.js، ابتدا باید ماژول fs را در برنامه‌ی خود ایمپورت کنیم. سپس با استفاده از تابع stat این ماژول، اطلاعات مربوط به یک فایل یا دایرکتوری را دریافت می‌کنیم. البته این تابع به صورت ناهمگام عمل می‌کند و یک کالبک (callback) را به عنوان پارامتر ورودی می‌پذیرد. ```javascript const fs = require('fs'); fs.stat('path/to/file', (err, stats) => { if (err) { console.error(err); return; } console.log(stats); }); ``` در کد بالا، ما ابتدا ماژول fs را ایمپورت کرده و سپس با استفاده از تابع stat این ماژول، اطلاعات مربوط به فایل یا دایرکتوری مورد نظر را دریافت می‌کنیم. اگر خطا رخ دهد، آن را چاپ می‌کنیم و در غیر این صورت اطلاعات را نمایش می‌دهیم. ## پارامترهای ورودی دستور fs.stat دستور fs.stat در Node.js، یک پارامتر ورودی دارد که مشخص می‌کند ما می‌خواهیم اطلاعات مربوط به کدام فایل یا دایرکتوری را دریافت کنیم. این پارامتر می‌تواند یک رشته حاوی آدرس فایل یا دایرکتوری باشد. ## خروجی دستور fs.stat دستور fs.stat در Node.js، یک شیء با حاوی اطلاعات مربوط به فایل یا دایرکتوری مورد نظر را به عنوان خروجی باز می‌گرداند. این شیء شامل ویژگی‌هایی مانند اندازه فایل، نوع فایل، زمان ساخت و تغییرات فایل و ... است. با استفاده از این اطلاعات، می‌توانیم در برنامه‌های خود به شکل مناسبی از فایل یا دایرکتوری استفاده کنیم. ## مثال‌های کاربردی دستور fs.stat برای روشن شدن نحوه استفاده از دستور fs.stat در Node.js، به برخی مثال‌های کاربردی آن می‌پردازیم: ### 1. دریافت اطلاعات یک فایل ```javascript const fs = require('fs'); fs.stat('path/to/file', (err, stats) => { if (err) { console.error(err); return; } console.log('File Size:', stats.size); console.log('File Type:', stats.isFile()); console.log('File Created At:', stats.ctime); console.log('File Modified At:', stats.mtime); }); ``` در این مثال، با استفاده از دستور fs.stat، اطلاعات مربوط به فایل مورد نظر را دریافت می‌کنیم. سپس این اطلاعات را چاپ می‌کنیم. اطلاعات شامل اندازه فایل، نوع فایل، زمان ساخت و تغییرات فایل و ... است. ### 2. بررسی نوع فایل ```javascript const fs = require('fs'); fs.stat('path/to/file', (err, stats) => { if (err) { console.error(err); return; } if (stats.isFile()) { console.log('This is a file.'); } else if (stats.isDirectory()) { console.log('This is a directory.'); } else { console.log('This is neither a file nor a directory.'); } }); ``` در این مثال، با استفاده از دستور fs.stat، اطلاعات مربوط به فایل مورد نظر را دریافت می‌کنیم. سپس با استفاده از متدهای isFile و isDirectory، نوع فایل را بررسی می‌کنیم و خروجی مناسب را چاپ می‌کنیم. ## دستور fs.statSync در Node.js علاوه بر دستور fs.stat که به صورت ناهمگام عمل می‌کند، در Node.js دستور fs.statSync نیز وجود دارد که به صورت همگام عمل می‌کند. این دستور اطلاعات مربوط به فایل یا دایرکتوری مورد نظر را بدون نیاز به استفاده از کالبک (callback) بازگردانی می‌کند. ```javascript const fs = require('fs'); try { const stats = fs.statSync('path/to/file'); console.log(stats); } catch (err) { console.error(err); } ``` در کد بالا، ما با استفاده از دستور fs.statSync، اطلاعات مربوط به فایل یا دایرکتوری مورد نظر را دریافت می‌کنیم. اگر خطا رخ دهد، آن را چاپ می‌کنیم. ## نکات مهم در استفاده از دستور fs.stat - اگر فایل یا دایرکتوری مورد نظر وجود نداشته باشد، خطا رخ می‌دهد. بنابراین قبل از استفاده از این دستور، باید از وجود فایل یا دایرکتوری اطمینان حاصل کنید. - استفاده از دستور fs.statSync به صورت همگام، می‌تواند در برخی مواقع مفید باشد، اما باید مراقب باشید که اگر فایل یا دایرکتوری بسیار بزرگی را بررسی کنید، عملیات اجرا طولانی مدتی طول خواهد کشید و برنامه شما ممکن است به نظر بی‌پاسخ باشد. ## مقایسه دستور fs.stat با دستورهای مشابه در Node.js، علاوه بر دستور fs.stat، دستورهای مشابهی نیز وجود دارند که قابل استفاده هستند. برخی از این د