فارسی

بر مدیریت صریح منابع جدید جاوا اسکریپت با `using` و `await using` مسلط شوید. یاد بگیرید چگونه آزادسازی منابع را خودکار کنید، از نشت منابع جلوگیری کرده و کدی تمیزتر و قوی‌تر بنویسید.

ابرقدرت جدید جاوا اسکریپت: نگاهی عمیق به مدیریت صریح منابع

در دنیای پویای توسعه نرم‌افزار، مدیریت مؤثر منابع سنگ بنای ساخت برنامه‌های قوی، قابل اعتماد و با کارایی بالا است. برای دهه‌ها، توسعه‌دهندگان جاوا اسکریپت به الگوهای دستی مانند try...catch...finally برای اطمینان از آزادسازی صحیح منابع حیاتی - مانند هندل‌های فایل، اتصالات شبکه یا نشست‌های پایگاه داده - تکیه کرده‌اند. اگرچه این رویکرد کاربردی است، اما اغلب پرحرف، مستعد خطا و در سناریوهای پیچیده به سرعت غیرقابل کنترل می‌شود، الگویی که گاهی به آن «هرم هلاکت» (pyramid of doom) گفته می‌شود.

اکنون یک تغییر پارادایم برای این زبان معرفی شده است: مدیریت صریح منابع (Explicit Resource Management - ERM). این ویژگی قدرتمند که در استاندارد ECMAScript 2024 (ES2024) نهایی شده و از ساختارهای مشابه در زبان‌هایی مانند سی‌شارپ، پایتون و جاوا الهام گرفته شده است، روشی اعلانی و خودکار برای مدیریت آزادسازی منابع معرفی می‌کند. با بهره‌گیری از کلمات کلیدی جدید using و await using، جاوا اسکریپت اکنون راه‌حلی بسیار زیباتر و امن‌تر برای یک چالش برنامه‌نویسی همیشگی ارائه می‌دهد.

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

روش قدیمی: چالش‌های آزادسازی دستی منابع

قبل از اینکه بتوانیم ظرافت سیستم جدید را درک کنیم، ابتدا باید نقاط ضعف سیستم قدیمی را بفهمیم. الگوی کلاسیک برای مدیریت منابع در جاوا اسکریپت، بلوک try...finally است.

منطق ساده است: شما یک منبع را در بلوک try به دست می‌آورید و آن را در بلوک finally آزاد می‌کنید. بلوک finally اجرا را تضمین می‌کند، چه کد در بلوک try موفق شود، چه شکست بخورد یا زودتر از موعد بازگردد.

بیایید یک سناریوی رایج سمت سرور را در نظر بگیریم: باز کردن یک فایل، نوشتن مقداری داده در آن و سپس اطمینان از بسته شدن فایل.

مثال: یک عملیات ساده فایل با try...finally


const fs = require('fs/promises');

async function processFile(filePath, data) {
  let fileHandle;
  try {
    console.log('در حال باز کردن فایل...');
    fileHandle = await fs.open(filePath, 'w');
    console.log('در حال نوشتن در فایل...');
    await fileHandle.write(data);
    console.log('داده‌ها با موفقیت نوشته شدند.');
  } catch (error) {
    console.error('خطایی در حین پردازش فایل رخ داد:', error);
  } finally {
    if (fileHandle) {
      console.log('در حال بستن فایل...');
      await fileHandle.close();
    }
  }
}

این کد کار می‌کند، اما چندین ضعف را آشکار می‌سازد:

حالا تصور کنید که چندین منبع را مدیریت می‌کنید، مانند یک اتصال پایگاه داده و یک هندل فایل. کد به سرعت به یک آشفتگی تو در تو تبدیل می‌شود:


async function logQueryResultToFile(query, filePath) {
  let dbConnection;
  try {
    dbConnection = await getDbConnection();
    const result = await dbConnection.query(query);

    let fileHandle;
    try {
      fileHandle = await fs.open(filePath, 'w');
      await fileHandle.write(JSON.stringify(result));
    } finally {
      if (fileHandle) {
        await fileHandle.close();
      }
    }
  } finally {
    if (dbConnection) {
      await dbConnection.release();
    }
  }
}

نگهداری و مقیاس‌پذیری این ساختار تو در تو دشوار است. این یک سیگنال واضح است که به یک انتزاع بهتر نیاز است. این دقیقاً همان مشکلی است که مدیریت صریح منابع برای حل آن طراحی شده است.

یک تغییر پارادایم: اصول مدیریت صریح منابع

مدیریت صریح منابع (ERM) یک قرارداد بین یک شیء منبع و ران‌تایم جاوا اسکریپت معرفی می‌کند. ایده اصلی ساده است: یک شیء می‌تواند نحوه آزادسازی خود را اعلام کند و زبان سینتکسی را برای انجام خودکار آن آزادسازی در زمانی که شیء از محدوده (scope) خارج می‌شود، فراهم می‌کند.

این امر از طریق دو جزء اصلی حاصل می‌شود:

  1. پروتکل یکبار مصرف (Disposable Protocol): یک روش استاندارد برای اشیاء جهت تعریف منطق آزادسازی خود با استفاده از سیمبل‌های ویژه: Symbol.dispose برای آزادسازی همزمان (synchronous) و Symbol.asyncDispose برای آزادسازی ناهمزمان (asynchronous).
  2. اعلان‌های `using` و `await using`: کلمات کلیدی جدیدی که یک منبع را به یک محدوده بلوک متصل می‌کنند. هنگامی که از بلوک خارج می‌شویم، متد آزادسازی منبع به طور خودکار فراخوانی می‌شود.

مفاهیم اصلی: `Symbol.dispose` و `Symbol.asyncDispose`

در قلب ERM دو سیمبل شناخته‌شده جدید قرار دارند. شیئی که متدی با یکی از این سیمبل‌ها به عنوان کلید خود داشته باشد، یک «منبع یکبار مصرف» (disposable resource) در نظر گرفته می‌شود.

آزادسازی همزمان با `Symbol.dispose`

سیمبل Symbol.dispose یک متد آزادسازی همزمان را مشخص می‌کند. این برای منابعی مناسب است که آزادسازی آنها به هیچ عملیات ناهمزمانی نیاز ندارد، مانند بستن همزمان یک هندل فایل یا آزاد کردن یک قفل درون حافظه‌ای (in-memory lock).

بیایید یک پوشش (wrapper) برای یک فایل موقت ایجاد کنیم که خود را پاکسازی می‌کند.


const fs = require('fs');
const path = require('path');

class TempFile {
  constructor(content) {
    this.path = path.join(__dirname, `temp_${Date.now()}.txt`);
    fs.writeFileSync(this.path, content);
    console.log(`فایل موقت ایجاد شد: ${this.path}`);
  }

  // این متد یکبار مصرف همزمان است
  [Symbol.dispose]() {
    console.log(`در حال آزادسازی فایل موقت: ${this.path}`);
    try {
      fs.unlinkSync(this.path);
      console.log('فایل با موفقیت حذف شد.');
    } catch (error) {
      console.error(`حذف فایل ناموفق بود: ${this.path}`, error);
      // مدیریت خطاها در داخل dispose نیز مهم است!
    }
  }
}

هر نمونه از `TempFile` اکنون یک منبع یکبار مصرف است. این کلاس متدی با کلید `Symbol.dispose` دارد که شامل منطق حذف فایل از دیسک است.

آزادسازی ناهمزمان با `Symbol.asyncDispose`

بسیاری از عملیات آزادسازی مدرن ناهمزمان هستند. بستن یک اتصال پایگاه داده ممکن است شامل ارسال یک فرمان `QUIT` از طریق شبکه باشد، یا یک کلاینت صف پیام ممکن است نیاز به تخلیه بافر خروجی خود داشته باشد. برای این سناریوها، ما از `Symbol.asyncDispose` استفاده می‌کنیم.

متد مرتبط با `Symbol.asyncDispose` باید یک `Promise` برگرداند (یا یک تابع `async` باشد).

بیایید یک اتصال پایگاه داده ساختگی (mock) را مدل کنیم که نیاز دارد به صورت ناهمزمان به یک استخر (pool) بازگردانده شود.


// یک استخر پایگاه داده ساختگی
const mockDbPool = {
  getConnection: () => {
    console.log('اتصال پایگاه داده دریافت شد.');
    return new MockDbConnection();
  }
};

class MockDbConnection {
  query(sql) {
    console.log(`در حال اجرای کوئری: ${sql}`);
    return Promise.resolve({ success: true, rows: [] });
  }

  // این متد یکبار مصرف ناهمزمان است
  async [Symbol.asyncDispose]() {
    console.log('در حال بازگرداندن اتصال پایگاه داده به استخر...');
    // شبیه‌سازی یک تأخیر شبکه برای آزادسازی اتصال
    await new Promise(resolve => setTimeout(resolve, 50));
    console.log('اتصال پایگاه داده آزاد شد.');
  }
}

اکنون، هر نمونه از `MockDbConnection` یک منبع یکبار مصرف ناهمزمان است. این کلاس می‌داند که چگونه خود را به صورت ناهمزمان در زمانی که دیگر مورد نیاز نیست، آزاد کند.

سینتکس جدید: `using` و `await using` در عمل

با تعریف کلاس‌های یکبار مصرف خود، اکنون می‌توانیم از کلمات کلیدی جدید برای مدیریت خودکار آنها استفاده کنیم. این کلمات کلیدی اعلان‌هایی با محدوده بلوک ایجاد می‌کنند، درست مانند `let` و `const`.

آزادسازی همزمان با `using`

کلمه کلیدی `using` برای منابعی استفاده می‌شود که `Symbol.dispose` را پیاده‌سازی کرده‌اند. هنگامی که اجرای کد از بلوکی که اعلان `using` در آن انجام شده خارج می‌شود، متد `[Symbol.dispose]()` به طور خودکار فراخوانی می‌شود.

بیایید از کلاس `TempFile` خود استفاده کنیم:


function processDataWithTempFile() {
  console.log('در حال ورود به بلوک...');
  using tempFile = new TempFile('این مقداری داده مهم است.');

  // شما می‌توانید در اینجا با tempFile کار کنید
  const content = fs.readFileSync(tempFile.path, 'utf8');
  console.log(`خوانده شده از فایل موقت: "${content}"`);

  // هیچ کد آزادسازی در اینجا لازم نیست!
  console.log('...در حال انجام کارهای بیشتر...');
} // <-- tempFile.[Symbol.dispose]() به طور خودکار درست در اینجا فراخوانی می‌شود!

processDataWithTempFile();
console.log('بلوک به پایان رسیده است.');

خروجی به این صورت خواهد بود:

در حال ورود به بلوک...
فایل موقت ایجاد شد: /path/to/temp_1678886400000.txt
خوانده شده از فایل موقت: "این مقداری داده مهم است."
...در حال انجام کارهای بیشتر...
در حال آزادسازی فایل موقت: /path/to/temp_1678886400000.txt
فایل با موفقیت حذف شد.
بلوک به پایان رسیده است.

ببینید چقدر تمیز است! کل چرخه حیات منبع در داخل بلوک قرار دارد. ما آن را اعلام می‌کنیم، از آن استفاده می‌کنیم و آن را فراموش می‌کنیم. زبان، آزادسازی را مدیریت می‌کند. این یک پیشرفت بزرگ در خوانایی و ایمنی است.

مدیریت چندین منبع

شما می‌توانید چندین اعلان `using` در یک بلوک داشته باشید. آنها به ترتیب معکوس ایجادشان (رفتار LIFO یا «پشته‌مانند») آزاد خواهند شد.


{
  using resourceA = new MyDisposable('A'); // اول ایجاد شد
  using resourceB = new MyDisposable('B'); // دوم ایجاد شد
  console.log('داخل بلوک، در حال استفاده از منابع...');
} // resourceB اول آزاد می‌شود، سپس resourceA

آزادسازی ناهمزمان با `await using`

کلمه کلیدی `await using` همتای ناهمزمان `using` است. این برای منابعی استفاده می‌شود که `Symbol.asyncDispose` را پیاده‌سازی کرده‌اند. از آنجایی که آزادسازی ناهمزمان است، این کلمه کلیدی فقط می‌تواند در داخل یک تابع `async` یا در سطح بالای یک ماژول (اگر top-level await پشتیبانی شود) استفاده شود.

بیایید از کلاس `MockDbConnection` خود استفاده کنیم:


async function performDatabaseOperation() {
  console.log('در حال ورود به تابع ناهمزمان...');
  await using db = mockDbPool.getConnection();

  await db.query('SELECT * FROM users');

  console.log('عملیات پایگاه داده کامل شد.');
} // <-- await db.[Symbol.asyncDispose]() به طور خودکار در اینجا فراخوانی می‌شود!

(async () => {
  await performDatabaseOperation();
  console.log('تابع ناهمزمان به پایان رسید.');
})();

خروجی، آزادسازی ناهمزمان را نشان می‌دهد:

در حال ورود به تابع ناهمزمان...
اتصال پایگاه داده دریافت شد.
در حال اجرای کوئری: SELECT * FROM users
عملیات پایگاه داده کامل شد.
در حال بازگرداندن اتصال پایگاه داده به استخر...
(50 میلی‌ثانیه منتظر می‌ماند)
اتصال پایگاه داده آزاد شد.
تابع ناهمزمان به پایان رسید.

درست مانند `using`، سینتکس `await using` کل چرخه حیات را مدیریت می‌کند، اما به درستی منتظر (`awaits`) فرآیند آزادسازی ناهمزمان می‌ماند. این حتی می‌تواند منابعی را که فقط به صورت همزمان قابل آزادسازی هستند مدیریت کند—فقط منتظر آنها نخواهد ماند.

الگوهای پیشرفته: `DisposableStack` و `AsyncDisposableStack`

گاهی اوقات، محدوده‌بندی ساده بلوکی `using` به اندازه کافی انعطاف‌پذیر نیست. اگر نیاز به مدیریت گروهی از منابع با چرخه‌ی حیاتی داشته باشید که به یک بلوک لغوی (lexical block) واحد وابسته نیست، چه؟ یا اگر در حال یکپارچه‌سازی با یک کتابخانه قدیمی هستید که اشیایی با `Symbol.dispose` تولید نمی‌کند، چه؟

برای این سناریوها، جاوا اسکریپت دو کلاس کمکی ارائه می‌دهد: `DisposableStack` و `AsyncDisposableStack`.

`DisposableStack`: مدیر آزادسازی انعطاف‌پذیر

یک `DisposableStack` شیئی است که مجموعه‌ای از عملیات آزادسازی را مدیریت می‌کند. خود این شیء یک منبع یکبار مصرف است، بنابراین می‌توانید کل چرخه حیات آن را با یک بلوک `using` مدیریت کنید.

این کلاس چندین متد مفید دارد:

مثال: مدیریت منابع شرطی

تابعی را تصور کنید که یک فایل لاگ را فقط در صورت برآورده شدن یک شرط خاص باز می‌کند، اما شما می‌خواهید تمام آزادسازی‌ها در یک مکان و در انتها انجام شود.


function processWithConditionalLogging(shouldLog) {
  using stack = new DisposableStack();

  const db = stack.use(getDbConnection()); // همیشه از پایگاه داده استفاده کن

  if (shouldLog) {
    const logFileStream = fs.createWriteStream('app.log');
    // آزادسازی برای استریم را به تعویق بینداز
    stack.defer(() => {
      console.log('در حال بستن استریم فایل لاگ...');
      logFileStream.end();
    });
    db.logTo(logFileStream);
  }

  db.doWork();

} // <-- پشته آزاد می‌شود و تمام توابع آزادسازی ثبت‌شده را به ترتیب LIFO فراخوانی می‌کند.

`AsyncDisposableStack`: برای دنیای ناهمزمان

همانطور که ممکن است حدس بزنید، `AsyncDisposableStack` نسخه ناهمزمان است. این کلاس می‌تواند هم منابع یکبار مصرف همزمان و هم ناهمزمان را مدیریت کند. متد آزادسازی اصلی آن `.disposeAsync()` است که یک `Promise` برمی‌گرداند که پس از تکمیل تمام عملیات آزادسازی ناهمزمان، resolve می‌شود.

مثال: مدیریت ترکیبی از منابع

بیایید یک کنترل‌کننده درخواست وب سرور ایجاد کنیم که به یک اتصال پایگاه داده (آزادسازی ناهمزمان) و یک فایل موقت (آزادسازی همزمان) نیاز دارد.


async function handleRequest() {
  await using stack = new AsyncDisposableStack();

  // مدیریت یک منبع یکبار مصرف ناهمزمان
  const dbConnection = await stack.use(getAsyncDbConnection());

  // مدیریت یک منبع یکبار مصرف همزمان
  const tempFile = stack.use(new TempFile('request data'));

  // پذیرش یک منبع از یک API قدیمی
  const legacyResource = getLegacyResource();
  stack.adopt(legacyResource, () => legacyResource.shutdown());

  console.log('در حال پردازش درخواست...');
  await doWork(dbConnection, tempFile.path);

} // <-- stack.disposeAsync() فراخوانی می‌شود. این متد به درستی منتظر آزادسازی ناهمزمان خواهد ماند.

`AsyncDisposableStack` ابزاری قدرتمند برای هماهنگ‌سازی منطق پیچیده راه‌اندازی و تخریب به شیوه‌ای تمیز و قابل پیش‌بینی است.

مدیریت خطای قوی با `SuppressedError`

یکی از ظریف‌ترین اما مهم‌ترین پیشرفت‌های ERM نحوه مدیریت خطاها است. چه اتفاقی می‌افتد اگر یک خطا در داخل بلوک `using` پرتاب شود و خطای *دیگری* در حین آزادسازی خودکار متعاقب آن پرتاب شود؟

در دنیای قدیمی `try...finally`، خطای بلوک `finally` معمولاً خطای اصلی و مهم‌تر بلوک `try` را بازنویسی یا «سرکوب» (suppress) می‌کرد. این امر اغلب اشکال‌زدایی را فوق‌العاده دشوار می‌کرد.

ERM این مشکل را با یک نوع خطای سراسری جدید حل می‌کند: `SuppressedError`. اگر خطایی در حین آزادسازی رخ دهد در حالی که خطای دیگری در حال انتشار است، خطای آزادسازی «سرکوب» می‌شود. خطای اصلی پرتاب می‌شود، اما اکنون دارای یک ویژگی `suppressed` است که حاوی خطای آزادسازی است.


class FaultyResource {
  [Symbol.dispose]() {
    throw new Error('خطا در حین آزادسازی!');
  }
}

try {
  using resource = new FaultyResource();
  throw new Error('خطا در حین عملیات!');
} catch (e) {
  console.log(`خطای گرفته‌شده: ${e.message}`); // خطا در حین عملیات!
  if (e.suppressed) {
    console.log(`خطای سرکوب‌شده: ${e.suppressed.message}`); // خطا در حین آزادسازی!
    console.log(e instanceof SuppressedError); // false
    console.log(e.suppressed instanceof Error); // true
  }
}

این رفتار تضمین می‌کند که شما هرگز زمینه شکست اصلی را از دست ندهید، که منجر به سیستم‌های بسیار قوی‌تر و قابل اشکال‌زدایی می‌شود.

موارد استفاده عملی در اکوسیستم جاوا اسکریپت

کاربردهای مدیریت صریح منابع گسترده و برای توسعه‌دهندگان در سراسر جهان، چه در بک‌اند، فرانت‌اند یا در تست کار کنند، مرتبط است.

پشتیبانی مرورگرها و ران‌تایم‌ها

به عنوان یک ویژگی مدرن، مهم است بدانید کجا می‌توانید از مدیریت صریح منابع استفاده کنید. از اواخر سال 2023 / اوایل 2024، پشتیبانی در آخرین نسخه‌های محیط‌های اصلی جاوا اسکریپت گسترده است:

برای محیط‌های قدیمی‌تر، باید به ترنسپایلرهایی مانند Babel با پلاگین‌های مناسب برای تبدیل سینتکس `using` و پلی‌فیل کردن سیمبل‌ها و کلاس‌های پشته لازم تکیه کنید.

نتیجه‌گیری: دورانی جدید از ایمنی و وضوح

مدیریت صریح منابع جاوا اسکریپت چیزی بیش از یک شیرین‌کننده سینتکسی (syntactic sugar) است؛ این یک بهبود اساسی در زبان است که ایمنی، وضوح و قابلیت نگهداری را ترویج می‌کند. با خودکارسازی فرآیند خسته‌کننده و مستعد خطای آزادسازی منابع، توسعه‌دهندگان را آزاد می‌گذارد تا بر منطق اصلی کسب‌وکار خود تمرکز کنند.

نکات کلیدی عبارتند از:

هنگام شروع پروژه‌های جدید یا بازسازی کدهای موجود، اتخاذ این الگوی قدرتمند جدید را در نظر بگیرید. این کار جاوا اسکریپت شما را تمیزتر، برنامه‌هایتان را قابل اعتمادتر و زندگی شما به عنوان یک توسعه‌دهنده را کمی آسان‌تر خواهد کرد. این یک استاندارد واقعاً جهانی برای نوشتن جاوا اسکریپت مدرن و حرفه‌ای است.