نظام الملفات Node.js (FS)

Node.js FS

Node FS是Node.js中的内置模块，可帮助您处理文件并对其进行操作。

NodeJs FS文件操作

使用Node FS，您可以对文件执行以下操作：

• قراءة الملف

• 创建或覆盖文件

• 更新文件

• إزالة الملف

• 重命名文件

Node.js 提供一组类似 UNIX(POSIX)标准的文件操作API。 Node 导入文件系统模块(fs)语法如下所示：

var fs = require("fs")

异步和同步

Node.js 文件系统（fs 模块）模块中的方法均有异步和同步版本，例如读取文件内容的函数有异步的 fs.readFile() 和同步的 fs.readFileSync()。

异步的方法函数最后一个参数为回调函数，回调函数的第一个参数包含了错误信息(error)。

建议大家使用异步方法，比起同步，异步方法性能更高，速度更快，而且没有阻塞。

مثال

创建 input.txt 文件，内容如下：

عنوان الموقع الرسمي للدليل الأساسي: ar.oldtoolbag.com
مثال على قراءة الملف

创建 file.js 文件, 代码如下：

var fs = require("fs");
// 异步读取
fs.readFile('input.txt', function(err, data) {
　　　if (err) {
　　　　　　　return console.error(err);
　　　}
　　　console.log("异步读取: " + data.toString());
});
// 同步读取
var data = fs.readFileSync('input.txt');
console.log("قراءة متسلسلة: " + data.toString());
console.log("انتهاء تنفيذ البرنامج.");

نتيجة تنفيذ الكود أعلاه كالتالي:

$ node file.js　
قراءة متسلسلة: رابط الدليل الأساسي للتدريب: ar.oldtoolbag.com
مثال على قراءة الملف
انتهاء تنفيذ البرنامج.
قراءة متسلسلة: رابط الدليل الأساسي للتدريب: ar.oldtoolbag.com
مثال على قراءة الملف

دعونا نتعرف على طرق نظام الملفات في Node.js بشكل دقيق.

فتح الملف

النصوص

هذه هي صيغة جملة فتح الملف في النمط المتسلسل:

fs.open(path, flags[, mode], callback)

المعلمات

تفاصيل استخدام المعلمات كما يلي:

• مسار - مسار الملف.

• flags - سلوك فتح الملف. يمكن العثور على القيم المحددة في النص أدناه.

• mode - تعيين نمط الملف (الصلاحيات)، صلاحيات إنشاء الملف الافتراضية هي 0666 (قابل للقراءة، قابل للكتابة).

• callback - وظيفة الاستدعاء، تحتوي على اثنين من المعلمات مثل: callback(err, fd).

يمكن أن تكون قيمة المعلمة flags من القيم التالية:

مثال

الآن سنقوم بإنشاء ملف file.js، وفتح ملف input.txt للقراءة والكتابة، وفقًا للكود التالي:

var fs = require("fs");
// فتح ملف بشكل متسلسل
console.log("إعداد فتح الملف!");
fs.open('input.txt', 'r+', function(err, fd) {
　　　if (err) {
　　　　　　　return console.error(err);
　　　}
　　console.log("نجاح في فتح الملف!");　　　　　
});

نتيجة تنفيذ الكود أعلاه كالتالي:

$ node file.js　
准备打开文件！
إعداد فتح الملف!

الحصول على معلومات الملف

النصوص

هذه هي صيغة جملة الحصول على معلومات الملف عبر النمط المتسلسل:

fs.stat(path, callback)

المعلمات

تفاصيل استخدام المعلمات كما يلي:

• مسار - مسار الملف.

• callback - وظيفة الاستدعاء، تحتوي على اثنين من المعلمات مثل: (err, stats), stats هو كائن fs.Stats.

fs.stat(path) بعد تنفيذها، سيقوم بإرجاع نموذج instance من الكائن stats إلى وظيفة الاستدعاء الخاصة بها. يمكن استخدام الطرق المتاحة في الكائن stats للتحقق من خصائص الملف. على سبيل المثال، لتحديد ما إذا كان الملفًا:

var fs = require('fs');
fs.stat('/Users/liuht/code/itbilu/demo/fs.js', function err, stats) {
　　　　console.log(stats.isFile()); // صحيح
})

الطريقة في فئة stats:

مثال

فيما يلي إنشاء ملف file.js، والكود كالتالي:

var fs = require("fs");
console.log("إعداد فتح الملف!");
fs.stat('input.txt', function err, stats) {
　　　if (err) {
　　　　　　　return console.error(err);
　　　}
　　　console.log(stats);
　　　console.log("نجح في قراءة معلومات الملف!");
　　　
　　　// فحص نوع الملف
　　　console.log("هل هو ملف (isFile)؟ " + stats.isFile());
　　　console.log("هل هو مجلد (isDirectory)؟ " + stats.isDirectory());　　　　
});

نتيجة تنفيذ الكود أعلاه كالتالي:

$ node file.js　
准备打开文件！
{ dev: 16777220,
　　mode: 33188,
　　nlink: 1,
　　uid: 501,
　　gid: 20,
　　rdev: 0,
　　blksize: 4096,
　　ino: 40333161,
　　size: 61,
　　blocks: 8,
　　atime: Mon Sep 07 2015 17:43:55 GMT+0800 (CST),
　　mtime: Mon Sep 07 2015 17:22:35 GMT+0800 (CST),
　　ctime: Mon Sep 07 2015 17:22:35 GMT+0800 (CST)
تم قراءة معلومات الملف بنجاح!}
هل هو ملف (isFile)؟ نعم
هل هو مجلد (isDirectory)؟ لا

كتابة الملف

النصوص

نموذج جملة كتابة الملف في الوضع غير المتزامن هو كما يلي:

fs.writeFile(file, data[, options], callback)

يفتح writeFile الملف بشكل افتراضي w الوضع،لذا إذا كان الملف موجودًا،سيقوم هذا النهج بكتابة محتويات جديدة تغطي المحتويات القديمة.

المعلمات

تفاصيل استخدام المعلمات كما يلي:

• file - اسم الملف أو معرف الملف.

• data - البيانات التي سيتم كتابتها في الملف،يمكن أن تكون String (النص) أو Buffer (البايتات).

• options - هذا المعرف هو دالة تحتوي على {encoding, mode, flag}،الترميز الافتراضي utf8،الوضع الافتراضي 0666،العلامة 'w'.

• callback - دالة التدفق،تتضمن فقط معرفات الأخطاء (err)،تُعيد في حالة الفشل.

مثال

فيما يلي إنشاء ملف file.js، والكود كالتالي:

var fs = require("fs");
console.log("إعداد الكتابة في الملف");
fs.writeFile('input.txt', 'أنا أقوم بكتابة محتويات الملف عبر fs.writeFile', function(err) {
　　　if (err) {
　　　　　　　return console.error(err);
　　　}
　　　console.log("تم كتابة البيانات بنجاح!");
　　　console.log("--------أنا خط الفصل-------------")
　　　console.log("قراءة البيانات المكتوبة!");
　　　fs.readFile('input.txt', function(err, data) {
　　　　　　if (err) {
　　　　　　　　　return console.error(err);
　　　　　　}
　　　　　　console.log("قراءة بيانات الملف بشكل غير متزامن: " + data.toString());
　　　});
});

نتيجة تنفيذ الكود أعلاه كالتالي:

$ node file.js　
إعداد الكتابة في الملف
تم كتابة البيانات بنجاح!
--------أنا خط الفصل-------------
قراءة البيانات المكتوبة!
قراءة بيانات الملف بشكل غير متزامن: أنا أقوم بكتابة محتويات الملف عبر fs.writeFile

قراءة الملف

النصوص

نموذج جملة قراءة الملف في الوضع غير المتزامن هو كما يلي:

fs.read(fd, buffer, offset, length, position, callback)

يستخدم هذا الطريقة وصف ملف لقراءة الملف.

المعلمات

تفاصيل استخدام المعلمات كما يلي:

• fd - ملف الوصف المعدل من قبل طريقة fs.open().

• buffer - منطقة التخزين التي سيتم فيها كتابة البيانات.

• offset - إزاحة الكتابة في منطقة التخزين.

• length - عدد البايتات التي سيتم قراءتها من الملف.

• position - موقع البداية لقراءة الملف،إذا كان قيمة position null،سيتم قراءة من موقع المؤشر الحالي للملف.

• callback - الدالة التدريبية، تحتوي على ثلاثة معاملات: err, bytesRead, buffer،err هو معلومات الخطأ، bytesRead هو عدد الأحرف المقرأه، buffer هو كائن المخزن المؤقت.

مثال

محتويات ملف input.txt هي:

عنوان الموقع الرسمي للدليل الأساسي: ar.oldtoolbag.com

فيما يلي إنشاء ملف file.js، والكود كالتالي:

var fs = require("fs");
var buf = new Buffer.alloc(1024);
console.log("إعداد فتح ملف موجود!");
fs.open('input.txt', 'r+', function(err, fd) {
　　　if (err) {
　　　　　　　return console.error(err);
　　　}
　　　console.log("نجاح في فتح الملف!");
　　　console.log("إعداد قراءة الملف:");
　　　fs.read(fd, buf, 0, buf.length, 0, function(err, bytes) {
　　　　　　if (err) {
　　　　　　　　　console.log(err);
　　　　　　}
　　　　　　console.log(bytes + " حرف تم قراءته");
　　　　　　
　　　　　　// فقط عرض الأحرف المقرأه
　　　　　　if (bytes > 0) {
　　　　　　　　　console.log(buf.slice(0, bytes).toString());
　　　　　　}
　　　});
});

نتيجة تنفيذ الكود أعلاه كالتالي:

$ node file.js　
إعداد فتح ملف موجود!
إعداد فتح الملف!
إعداد قراءة الملف:
تم قراءة 42 حرف
عنوان الموقع الرسمي للدليل الأساسي: ar.oldtoolbag.com

إغلاق الملف

النصوص

النحو التالي هو نموذج إغلاق الملف في الوضع المتسلسل:

fs.close(fd, callback)

يستخدم هذا الطريقة وصف ملف لقراءة الملف.

المعلمات

تفاصيل استخدام المعلمات كما يلي:

• fd - ملف الوصف المعدل من قبل طريقة fs.open().

• callback - دالة الإصدار، لا يوجد أي معاملات.

مثال

محتويات ملف input.txt هي:

عنوان الموقع الرسمي للدليل الأساسي: ar.oldtoolbag.com

فيما يلي إنشاء ملف file.js، والكود كالتالي:

var fs = require("fs");
var buf = new Buffer.alloc(1024);
console.log("إعداد فتح الملف!");
fs.open('input.txt', 'r+', function(err, fd) {
　　　if (err) {
　　　　　　　return console.error(err);
　　　}
　　　console.log("نجاح في فتح الملف!");
　　　console.log("إعداد قراءة الملف!");
　　　fs.read(fd, buf, 0, buf.length, 0, function(err, bytes) {
　　　　　　if (err) {
　　　　　　　　　console.log(err);
　　　　　　}
　　　　　　// فقط عرض الأحرف المقرأه
　　　　　　if (bytes > 0) {
　　　　　　　　　console.log(buf.slice(0, bytes).toString());
　　　　　　}
　　　　　　// إغلاق الملف
　　　　　　fs.close(fd, function(err) {
　　　　　　　　　if (err) {
　　　　　　　　　　　　console.log(err);
　　　　　　　　　}　
　　　　　　　　　console.log("نجاح في إغلاق الملف");
　　　　　　});
　　　});
});

نتيجة تنفيذ الكود أعلاه كالتالي:

$ node file.js　
准备打开文件！
إعداد فتح الملف!
إعداد قراءة الملف!
عنوان الموقع الرسمي للدليل الأساسي: ar.oldtoolbag.com
تم إغلاق الملف بنجاح

قطع الملف

النصوص

النحو التالي هو نموذج قطع الملف في الوضع المتسلسل:

fs.ftruncate(fd, len, callback)

يستخدم هذا الطريقة وصف ملف لقراءة الملف.

المعلمات

تفاصيل استخدام المعلمات كما يلي:

• fd - ملف الوصف المعدل من قبل طريقة fs.open().

• len - طول ملف محتويات القطع.

• callback - دالة الإصدار، لا يوجد أي معاملات.

مثال

محتويات ملف input.txt هي:

الموقع: ar.oldtoolbag.com

فيما يلي إنشاء ملف file.js، والكود كالتالي:

var fs = require("fs");
var buf = new Buffer.alloc(1024);
console.log("إعداد فتح الملف!");
fs.open('input.txt', 'r+', function(err, fd) {
　　　if (err) {
　　　　　　　return console.error(err);
　　　}
　　　console.log("نجاح في فتح الملف!");
　　　console.log("قطع محتويات الملف لـ 10 أحرف، والجزء المتبقي سيتم إزالته.");
　　　
　　　// قطع الملف
　　　fs.ftruncate(fd, 10, function(err) {
　　　　　　if (err) {
　　　　　　　　　console.log(err);
　　　　　　}　
　　　　　　console.log("نجاح في قطع الملف.");
　　　　　　console.log("قراءة نفس الملف");　
　　　　　　fs.read(fd, buf, 0, buf.length, 0, function(err, bytes) {
　　　　　　　　　if (err) {
　　　　　　　　　　　　console.log(err);
　　　　　　　　　}
　　　　　　　　　// فقط عرض الأحرف المقرأه
　　　　　　　　　if (bytes > 0) {
　　　　　　　　　　　　console.log(buf.slice(0, bytes).toString());
　　　　　　　　　}
　　　　　　　　　// إغلاق الملف
　　　　　　　　　fs.close(fd, function(err) {
　　　　　　　　　　　　if (err) {
　　　　　　　　　　　　　　　console.log(err);
　　　　　　　　　　　　}　
　　　　　　　　　　　　console.log("نجاح في إغلاق الملف!");
　　　　　　　　　});
　　　　　　});
　　　});
});

نتيجة تنفيذ الكود أعلاه كالتالي:

$ node file.js　
准备打开文件！
إعداد فتح الملف!
فتح الملف بنجاح!
تم قطع محتويات الملف داخل 10 بيت، والجزء الذي يزيد عن ذلك سيتم إزالته.
قراءة نفس الملف
الموقع: www.r
تم إغلاق الملف بنجاح

إزالة الملف

النصوص

ما يلي هو نموذج النصوص لإزالة الملفات:

fs.unlink(path, callback)

المعلمات

تفاصيل استخدام المعلمات كما يلي:

• مسار - مسار الملف.

• callback - دالة الإصدار، لا يوجد أي معاملات.

مثال

محتويات ملف input.txt هي:

الموقع: ar.oldtoolbag.com

فيما يلي إنشاء ملف file.js، والكود كالتالي:

var fs = require("fs");
console.log("إعداد إزالة الملف!");
fs.unlink('input.txt', function(err) {
　　　if (err) {
　　　　　　　return console.error(err);
　　　}
　　　console.log("تم إزالة الملف بنجاح!");
});

نتيجة تنفيذ الكود أعلاه كالتالي:

$ node file.js　
إعداد إزالة الملف!
تم إزالة الملف بنجاح!

ومن ثم عرض ملف input.txt، وجد أنه غير موجود.

إنشاء المجلدات

النصوص

ما يلي هو نموذج النصوص لإنشاء المجلدات:

fs.mkdir(path[, options], callback)

المعلمات

تفاصيل استخدام المعلمات كما يلي:

• مسار - مسار الملف.

• يمكن أن تكون معلمات options كما يلي:

• recursive - هل يتم إنشاء المجلد بشكل تتابعي، القيمة الافتراضية هي false.

• mode - تعيين صلاحيات المجلد، القيمة الافتراضية هي 0777.

• callback - دالة الإصدار، لا يوجد أي معاملات.

مثال

فيما يلي إنشاء ملف file.js، والكود كالتالي:

var fs = require("fs");
// يجب أن يكون مجلد /tmp موجودًا
console.log("إنشاء مجلد /tmp/test/");
fs.mkdir("/tmp/test/", function(err) {
　　　if (err) {
　　　　　　　return console.error(err);
　　　}
　　　console.log("تم إنشاء المجلد بنجاح.");
});

نتيجة تنفيذ الكود أعلاه كالتالي:

$ node file.js　
إنشاء مجلد /tmp/test/
تم إنشاء المجلد بنجاح.

يمكن إضافة معلمات مثل recursive: true، حيث يتم إنشاء المجلدات /tmp و /tmp/a حتى لو كانت موجودة بالفعل:

fs.mkdir('/tmp/a/apple', { recursive: true }, (err) => {
　　if (err) throw err;
});

قراءة المجلدات

النصوص

ما يلي هو نموذج النصوص للقراءة المجلدات:

fs.readdir(path, callback)

المعلمات

تفاصيل استخدام المعلمات كما يلي:

• مسار - مسار الملف.

• callback - دالة التبويب، دالة التبويب تحتوي على اثنين من المعلمات: err و files، حيث أن err هو معلومات الخطأ، و files هو قائمة بالملفات الموجودة في المجلد.

مثال

فيما يلي إنشاء ملف file.js، والكود كالتالي:

var fs = require("fs");
console.log("عرض مجلد /tmp");
fs.readdir("/tmp/",function(err, files){
　　　if (err) {
　　　　　　　return console.error(err);
　　　}
　　　files.forEach( function (file){
　　　　　　　console.log( file );
　　　});
});

نتيجة تنفيذ الكود أعلاه كالتالي:

$ node file.js　
عرض مجلد /tmp
input.out
output.out
test
test.txt

إزالة المجلدات

النصوص

ما يلي هو نموذج النصوص للإزالة المجلدات:

fs.rmdir(path, callback)

المعلمات

تفاصيل استخدام المعلمات كما يلي:

• مسار - مسار الملف.

• callback - دالة الإصدار، لا يوجد أي معاملات.

مثال

فيما يلي إنشاء ملف file.js، والكود كالتالي:

var fs = require("fs");
// إنشاء مجلد فارغ "/tmp/test" قبل التنفيذ
console.log("إعداد حذف مجلد "/tmp/test"
fs.rmdir("/tmp/test",function(err){
　　　if (err) {
　　　　　　　return console.error(err);
　　　}
　　　console.log("قراءة مجلد "/tmp"
　　　fs.readdir("/tmp/",function(err, files){
　　　　　　if (err) {
　　　　　　　　　　return console.error(err);
　　　　　　}
　　　　　　files.forEach( function (file){
　　　　　　　　　　console.log( file );
　　　　　　});
　　　});
});

نتيجة تنفيذ الكود أعلاه كالتالي:

$ node file.js　
إعداد حذف مجلد "/tmp/test"
قراءة مجلد "/tmp"
……

دليل الطرق للمodule الملفات

الآتي هو قائمة الطرق المماثلة لمodule الملفات في Node.js:

لمعرفة المزيد من المعلومات، يرجى زيارة وصف وحدة الوثائق على الموقع الرسمي:نظام الملفات.