متد ajaxError

آموزش JQuery با رویدادهای Ajax به شما کمک می‌کند درخواست‌های ناهمگام را مدیریت کنید. متد ajaxError یک هندلر سراسری برای زمانی است که درخواست Ajax با خطا روبه‌رو می‌شود. در این حالت می‌توانید پیام خطا نشان دهید، وضعیت درخواست را ثبت کنید یا رابط کاربری را به حالت مناسب برگردانید.

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

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

در شکل کلی زیر، یک تابع به عنوان handler رویداد خطا معرفی می‌شود. در نسخه‌های قدیمی jQuery، این متد به شکل زیر نوشته می‌شد:

$( selector ).ajaxError( function( event, xhr, options ) {
  // Handle the Ajax error
});

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

نکته مهم این است که شیوه قدیمی فراخوانی رویدادها در jQuery در نسخه‌های جدیدتر توصیه نمی‌شود. از نسخه 1.9 به بعد، رویدادهای سراسری Ajax باید روی شیء document ثبت شوند. بنابراین برای کدهای جدید، استفاده از .on("ajaxError", ...) گزینه مناسب‌تری است.

در مثال زیر، رویداد خطای سراسری روی document ثبت می‌شود. اگر درخواست Ajax شکست بخورد، پیام عمومی به کاربر نمایش داده خواهد شد:

$(document).on("ajaxError", function(event, jqXHR, settings, thrownError) {
  alert("An error occurred!");
});

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

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

این رویداد برای درخواست‌هایی کاربرد دارد که از طریق jQuery ارسال می‌شوند و رویدادهای سراسری Ajax در آن‌ها فعال هستند. اگر برای یک درخواست گزینه global: false تنظیم شود، رویدادهای سراسری آن درخواست اجرا نمی‌شوند. این نکته را هنگام عیب‌یابی رفتار غیرمنتظره در نظر بگیرید.

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

ثبت handler روی document به معنی مدیریت تمام رخدادهای برنامه نیست؛ تنظیمات هر درخواست هم اهمیت دارند. اگر رویداد اجرا نمی‌شود، بررسی کنید درخواست با jQuery ارسال شده باشد و گزینه global آن غیرفعال نشده باشد.

پیام‌هایی مانند «درخواست انجام نشد؛ لطفا دوباره تلاش کنید» برای کاربر قابل فهم هستند و جزئیات فنی غیرضروری را افشا نمی‌کنند. در صورت نیاز، اطلاعات تکمیلی را در سامانه ثبت رخداد نگه دارید تا تیم فنی بتواند علت را بررسی کند.

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

گاهی یک درخواست به دلیل ورودی نامعتبر شکست می‌خورد و همان فرم باید پیام اختصاصی نشان دهد. در چنین شرایطی، handler سراسری ممکن است پیام دیگری نیز نمایش دهد و تجربه کاربری را گیج‌کننده کند. بهتر است مسئولیت هر سطح از مدیریت خطا را از ابتدا روشن کنید.

برای خطاهای مختص یک درخواست، تنظیمات همان درخواست یا callbackهای آن گزینه مناسبی هستند. از رویداد سراسری زمانی استفاده کنید که قصد دارید رفتار مشترکی برای چند درخواست داشته باشید؛ برای نمونه ثبت خطا یا نمایش پیام عمومی در بخش‌های مختلف برنامه.

متد ajaxError در jQuery برای واکنش به خطاهای درخواست Ajax و مدیریت سراسری آن‌ها کاربرد دارد. این رویداد می‌تواند برای اطلاع‌رسانی، ثبت رخداد و هماهنگ‌کردن رفتار بخش‌های مختلف صفحه مفید باشد؛ به شرطی که پیام‌های عمومی با پیام‌های اختصاصی هر درخواست تداخل نداشته باشند.

برای کد جدید، رویداد را با $(document).on("ajaxError", ...) ثبت کنید و اطلاعات درخواست را با دقت بررسی کنید. اگر فقط یک عملیات مشخص به رسیدگی نیاز دارد، مدیریت خطا را نزدیک همان درخواست نگه دارید. انتخاب درست میان این روش‌ها باعث می‌شود کد خواناتر و تجربه کاربری قابل پیش‌بینی‌تر باشد.