Node.js یک محیط اجرای قدرتمند جاوااسکریپت است که به ما این امکان را می‌دهد تا کدهای جاوااسکریپتی خود را خارج از مرورگر اجرا کنیم. توجه به این نکته لازم است که بخش اساسی بسیاری از برنامه‌های Node.js مدیریت انواع فایل است. این فایل‌ها می‌توانند Text، JSON، HTML یا سایر فرمت‌های فایل را شامل شوند. بنابراین لازم است که با نحوه خواندن و نوشتن فایل‌ها آشنا شویم و آن را یاد بگیریم.

فایل‌ها نقش بسیار مهمی در ذخیره‌سازی داده‌ها دارند. Node.js یک ماژول قدرتمند fs (file system) برای تعامل یکپارچه با این فایل‌ها ارائه می‌دهد. فرض کنید می‌خواهیم یک فایل JSON را در Node.js بخوانیم. ماژول

در این مقاله قصد داریم تا عملکردهای اصلی این ماژول را باهم بررسی کنیم، تکنیک‌های مختلف برای خواندن انواع فایل‌های مختلف را یاد بگیریم.

ماژول fs در Node.js

ماژول File System (fs) یک کامپوننت ضروری از محیط اجرا Node.js است. این ماژول ویژگی‌های مختلفی را برای تعامل با فایل سیستم‌های کامپیوتر برای ما فراهم می‌کند.

در ادامه جنبه‌های کلیدی ماژول

1. ماژول
   fs
   fs در هسته خود مجموعه‌ای از APIها را برای تعامل با فایل سیستم ارائه می‌کند. به عنوان مثال، راه‌هایی برای انجام فعالیت‌های اساسی مانند خواندن محتویات فایل، نوشتن داده‌ها در فایل‌ها، ایجاد دایرکتوری‌ها، حذف فایل‌ها و غیره از جمله این موارد هستند.
2. این ماژول شامل روش‌های synchronous و asynchronous برای تعامل با فایل‌ها است. روش‌های synchronous اجرای برنامه را تا زمانی که عملیات کامل شود مسدود می‌کند. اما روش‌های asynchronous برای سناریوهایی ایده‌آل است که در آن نیاز به انجام کارهای همزمان بدون توقف اجرای کل برنامه داریم.
3. همچنین این ماژول از مدیریت دایرکتوری‌ها مانند ایجاد دایرکتوری‌ها، حذف دایرکتوری‌ها و فهرست کردن محتویات دایرکتوری پشتیبانی می‌کند.
4. علاوه بر این، این ماژول از کار با file streamها نیز پشتیبانی می‌کند و امکان مدیریت کارآمد فایل‌های بزرگ را با خواندن یا نوشتن داده‌ها در chunkها، بدون لود کردن کل محتوا در حافظه فراهم می‌نماید. همچنین استفاده از بافرها برای مدیریت داده‌های باینری را نیز تسهیل می‌کند.

نحوه مدیریت فایل با استفاده از Node.js

برای درک بهتر مدیریت فایل و فرآیند خواندن و نوشتن آن‌ها در Node.js مثال زیر را بررسی می‌کنیم. ما سناریویی را فرض می‌کنیم که در آن دو فایل داریم:

محتوای داخل

[
  { "id": 1, "name": "Alice" },
  { "id": 2, "name": "Bob" },
  { "id": 3, "name": "Charlie" }
]

محتوای داخل

[
  { "id": 1, "address": "123 Main St" },
  { "id": 2, "address": "456 Elm St" },
  { "id": 3, "address": "789 Oak St" }
]

هدف ما ایجاد یک فایل

[
  {
    "id": 1,
    "name": "Alice",
    "address": "123 Main St"
  },
  {
    "id": 2,
    "name": "Bob",
    "address": "456 Elm St"
  },
  {
    "id": 3,
    "name": "Charlie",
    "address": "789 Oak St"
  }
]

قدم اول – import پکیج‌های path و fs از Node.js

کار خود را با ایجاد یک فایل

const fs = require("fs");

قدم دوم – خواندن از فایل‌ها

در مرحله بعد، داده‌های دو فایل را با استفاده از Node.js می‌خوانیم. ما یک تابع utility می‌سازیم تا به کمک آن بتوانیم فایل‌ها را به راحتی در محیط Node.js بخوانیم.

async function readJSONFile(filename) {
  try {
    const data = await fs.readFile(filename, "utf8");
    return JSON.parse(data);
  } catch (error) {
    console.error(`Error reading ${filename}: ${error}`);
    return [];
  }
}

از آنجایی که در مثال خود از فایل‌های JSON استفاده می‌کنیم، یک متد

در داخل بلاک

اگر در حین خواندن یا تجزیه خطایی رخ دهد، اجرای کد در بلاک

قدم سوم – اجرای تابع main

مرحله بعدی ایجاد یک تابع

async function main() {
  try {
    const names = await readJSONFile("names.json");
    const addresses = await readJSONFile("address.json");

    const bioData = names.map((name) => {
      const matchingAddress = addresses.find(
        (address) => address.id === name.id
      );
      return { ...name, ...matchingAddress };
    });

    await fs.writeFile("bio.json", JSON.stringify(bioData, null, 2));
    console.log("bio.json created successfully!");
  } catch (error) {
    console.error("Error combining data:", error);
  }
}

در تابع

سپس، هر

این جستجو

هنگامی که تمام آبجکت‌های

بلاک

کد کامل

کد تکمیل شده ما به شکل زیر می‌باشد:

const fs = require("fs").promises;

async function readJSONFile(filename) {
  try {
    const data = await fs.readFile(filename, "utf8");
    return JSON.parse(data);
  } catch (error) {
    console.error(`Error reading ${filename}: ${error}`);
    return [];
  }
}

async function main() {
  try {
    const names = await readJSONFile("names.json");
    const addresses = await readJSONFile("address.json");

    const bioData = names.map((name) => {
      const matchingAddress = addresses.find(
        (address) => address.id === name.id
      );
      return { ...name, ...matchingAddress };
    });

    await fs.writeFile("bio.json", JSON.stringify(bioData, null, 2));
    console.log("bio.json created successfully!");
  } catch (error) {
    console.error("Error combining data:", error);
  }
}

// Execute the main method
main();

می‌توانیم با استفاده از دستور زیر برنامه را اجرا کنیم:

node app.js

هنگامی که برنامه اجرا می‌شود، اگر همه چیز به خوبی پیش برود، گزارش‌های زیر را در ترمینال مشاهده می‌کنیم:

bio.json created successfully!

این نشان می‌دهد که فایل

[
  {
    "id": 1,
    "name": "Alice",
    "address": "123 Main St"
  },
  {
    "id": 2,
    "name": "Bob",
    "address": "456 Elm St"
  },
  {
    "id": 3,
    "name": "Charlie",
    "address": "789 Oak St"
  }
]

راه‌های خواندن فایل‌ها در Node.js

یکی از کارهایی که برای مدیریت فایل در Node.js باید انجام دهیم خواندن آن است. برای خواندن فایل‌ها در Node.js، بیشتر از این دو متد اصلی استفاده می‌کنیم:

متد ()fs.readFile

متد

به زبان ساده، این تابع به سایر عملیات‌ها اجازه می‌دهد تا زمانی که خواندن انجام می‌شود ادامه پیدا کنند. متد

• path
  path: مسیر فایلی که باید خوانده شود.
• encoding
  encoding: یک گزینه اختیاری است و encoding فایل را مشخص می‌کند (به عنوان مثال،
  "utf8"
  "utf8"). اگر ارائه نشده باشد، به طور پیش‌فرض مقدار
  "utf8"
  "utf8" را می‌گیرد.
• تابع callback: تابعی است که هنگام خواندن فایل فراخوانی می‌شود و یک گزینه اختیاری می‌باشد. این تابع سه آرگومان دریافت می‌کند:
  error
  error،
  data
  data و
  buffer
  buffer.

به عنوان مثال:

const fs = require("fs");

fs.readFile("data.txt", "utf8", (err, data) => {
  if (err) {
    console.error(err);
  } else {
    console.log(data); // data will be a string containing the content of the file
  }
});

متد ()fs.readFileSync

متد

این متد فقط دو پارامتر می‌گیرد:

• path
  path: مسیر فایلی که باید خوانده شود.
• encoding
  encoding: یک گزینه اختیاری است و encoding فایل را مشخص می‌کند (به عنوان مثال،
  "utf8"
  "utf8"). اگر ارائه نشده باشد، به طور پیش‌فرض مقدار
  "utf8"
  "utf8" را می‌گیرد.

به عنوان مثال:

const fs = require("fs");

try {
  const data = fs.readFileSync("data.txt", "utf8");
  console.log(data); // data will be a string containing the content of the file
} catch (err) {
  console.error(err);
}

مقایسه متد ()fs.readFile و ()fs.readFileSync

برای درک تفاوت بین متدهای

ابتد با متد

const fs = require("fs");

fs.readFile("example.txt", "utf8", (err, data) => {
  console.log("Content from readFile:", data);
});

console.log("Completed reading file content asynchronously");

خروجی به شکل زیر می‌باشد:

Completed reading file content asynchronously
Content from readFile: freeCodeCamp is awesome!

به دلیل ماهیت asynchronous متد

در نهایت، زمانی که عملیات خواندن فایل به پایان رسید، تابع callback محتوای فایل را اجرا و ثبت می‌کند.

در ادامه، اجرای متد

const fs = require("fs");

const data = fs.readFileSync("data.txt", "utf8");
console.log("Content from readFileSync:", data);

console.log("Completed reading file content synchronously");

خروجی به شکل زیر می‌باشد:

Content from readFileSync: freeCodeCamp is awesome!
Completed reading file content synchronously

در مقابل، متد

به همین دلیل، پس از خواندن موفقیت‌آمیز محتوای فایل، پیام

اکنون تفاوت بین این دو متد را می‌دانیم. درک این تفاوت مهم است زیرا بر روی جریان برنامه تأثیر می‌گذارد.

نحوه خواندن یک فایل Text

خواندن یک فایل متنی در Node.js بسیار ساده است. مثالی را در نظر می‌گیریم که فایلی به نام

Learn Node.js with freeCodeCamp

اکنون می‌خواهیم محتویات این فایل را بخوانیم. می‌توانیم این کار را به این صورت انجام دهیم:

const fs = require("fs");

fs.readFile("message.txt", "utf8", (err, data) => {
  if (err) {
    console.log(err);
  } else {
    console.log(data);
  }
});

تابع callback محتوای فایل را در یک متغیر

const fs = require("fs");

fs.readFile("message.txt", "utf8", (err, data) => {
  if (err) {
    console.log(err);
  } else {
      let splittedWords = data.split(" ");
      console.log(splittedWords);
  }
});

در کد بالا، متغیر

[ 'Learn', 'Node.js', 'with', 'freeCodeCamp' ]

نحوه خواندن فایل‌های HTML

خواندن فایل‌های HTML از روشی مشابه برای خواندن فایل‌های Text در Node.js پیروی می‌کند. ما می‌توانیم از ماژول

const fs = require("fs");

fs.readFile("index.html", "utf8", (err, data) => {
  if (err) {
    console.log(err);
  } else {
    console.log(data);
  }
});

سپس می‌توانیم از محتوای HTML برای پردازش بیشتر، مانند رندر کردن آن با پکیج

نحوه خواندن فایل‌ها با URL

خواندن فایل‌ها با URL در Node.js شامل مراحل اضافی فراتر از ماژول native fs است. به طور معمول، ما باید از ماژول‌های اضافی مانند

const fs = require("fs");
const https = require("https");

const file = fs.createWriteStream("data.txt");

https.get(
  "https://example-files.online-convert.com/document/txt/example.txt",
  (response) => {
    var stream = response.pipe(file);

    stream.on("finish", function () {
      console.log("done");
    });
  }
);

ابتدا، یک جریان قابل نوشتن با نام فایل، مرتبط با فایل لوکال

در داخل تابع callback، اسکریپت پاسخ را مستقیماً به جریان قابل نوشتن ارسال می‌کند. این عملیات به طور موثر داده‌های دریافت شده از سرور remote را به فایل لوکال

در نهایت، یک event listener برای event

نحوه خواندن یک فایل JSON

دیدیم که چگونه می‌توانیم یک فایل JSON را با استفاده از ماژول

[
  {
    "id": 1,
    "name": "Alice",
    "address": "123 Main St"
  },
  {
    "id": 2,
    "name": "Bob",
    "address": "456 Elm St"
  },
  {
    "id": 3,
    "name": "Charlie",
    "address": "789 Oak St"
  }
]

در Node.js، ما JSON را به صورت زیر می‌خوانیم:

const fs = require("fs");

fs.readFile("bio.json", "utf8", (err, data) => {
  if (err) {
    console.log(err);
  } else {
    console.log(data);
  }
});

با این کار، داده‌های JSON در متغیر

const fs = require("fs");

fs.readFile("bio.json", "utf8", (err, data) => {
  if (err) {
    console.log(err);
  } else {
    const users = JSON.parse(data);
    users.forEach((user) => {
      console.log(`${user.name} with ID ${user.id} lives at ${user.address}`);
    });
  }
});

خروجی به شکل زیر می‌باشد:

Alice with ID 1 lives at 123 Main St
Bob with ID 2 lives at 456 Elm St
Charlie with ID 3 lives at 789 Oak St

در کد بالا، ابتدا متغیر

fs.promises

با استفاده از

یک عملیات readFile بیسیک با

const fs = require("fs").promises;

async function readTextFile() {
  try {
    const data = await fs.readFile("data.txt", "utf8");
    console.log(data);
  } catch (err) {
    console.error(err);
  }
}

readTextFile();

جمع‌بندی

ما در این مقاله سعی کردیم تا تکنیک‌های ضروری برای مدیریت فایل در Node.js با استفاده از ماژول