برنامه‌نویسی ناهمگام: Future، async و await

Asynchronous programming: futures, async, await

ترجمه راهنمای رسمی Dart برای انجام عملیات ناهمگام، کار با Future، نوشتن کد خوانا با async/await و مدیریت خطاها

فهرست مطالب این صفحه

عملیات‌های ناهمگام (Asynchronous Operations) به برنامه اجازه می‌دهند در حالی که منتظر تکمیل یک کار زمان‌بر (مانند دریافت داده از اینترنت، خواندن از پایگاه‌داده یا خواندن فایل) هستند، سایر کارها و رندر رابط کاربری را بدون توقف ادامه دهند.

در زبان Dart از اشیای Future همراه با کلمات کلیدی async و await برای مدیریت کدهای ناهمگام استفاده می‌شود.

مفهوم Future چیست؟

یک شیء از نوع Future<T> نماینده نتیجه‌ای از یک عملیات ناهمگام است که در آینده آماده خواهد شد و مقداری از نوع T تولید می‌کند (اگر عملیات خروجی نداشته باشد، نوع آن Future<void> است). یک Future می‌تواند در یکی از دو وضعیت زیر باشد:

  1. تکمیل‌نشده (Uncompleted): وضعیت اولیه Future پیش از پایان عملیات ناهمگام.
  2. تکمیل‌شده (Completed): پس از پایان عملیات، Future یا با یک مقدار موفق تکمیل می‌شود و یا با یک خطا (Error) پایان می‌یابد.

کار با async و await

کلمات کلیدی async و await روشی اعلانی و بسیار خوانا برای تعریف توابع ناهمگام و استفاده از نتایج آن‌ها فراهم می‌کنند:

  • برای تعریف یک تابع ناهمگام، کلیدواژه async را پیش از بدنه تابع قرار دهید.
  • کلیدواژه await فقط درون توابعی که با async علامت‌گذاری شده‌اند قابل استفاده است و اجرای همان تابع را تا زمان آماده شدن نتیجه Future متوقف می‌کند.
Dart
Future<String> fetchUserOrder() {
  // شبیه‌سازی دریافت اطلاعات از سرور با تأخیر ۲ ثانیه‌ای
  return Future.delayed(
    const Duration(seconds: 2),
    () => 'Large Latte',
  );
}

Future<void> main() async {
  print('در حال دریافت سفارش کاربر...');
  final order = await fetchUserOrder();
  print('سفارش شما آماده است: $order');
}

مدیریت خطاها با try و catch

در توابع ناهمگام مبتنی بر async و await، می‌توانید خطاهای احتمالی یک Future را دقیقاً مانند کدهای همگام با بلوک‌های try-catch مدیریت کنید:

Dart
Future<void> printOrderMessage() async {
  try {
    print('در انتظار دریافت سفارش...');
    final order = await fetchUserOrder();
    print('سفارش دریافت شد: $order');
  } catch (err) {
    print('خطا در دریافت سفارش: $err');
  }
}

اجرای هم‌زمان چند عملیات با Future.wait

اگر چند عملیات ناهمگام مستقل دارید و می‌خواهید همه آن‌ها به‌صورت هم‌زمان آغاز شوند و منتظر تکمیل تمام آن‌ها بمانید، از Future.wait استفاده کنید:

Dart
Future<void> loadDashboardData() async {
  final results = await Future.wait([
    fetchUserProfile(),
    fetchNotificationsCount(),
  ]);
  print('پروفایل: ${results[0]} | اعلان‌ها: ${results[1]}');
}