📞 02166056460

متد ajaxStop

10 / 10
از 1 کاربر
بازگشت به لیست مقالات » | جمعه 1 آبان 1405 در ساعت 19 و 48 دقیقه | نظرات کاربران ( 0 )
آموزش jQuery

متد ajaxStop در jQuery

تشخیص پایان همه درخواست های هم زمان Ajax و اجرای کد مناسب

در این راهنمای متد ajaxStop در jQuery یاد می گیرید چگونه پس از پایان تمام درخواست های Ajax فعال، یک تابع اجرا کنید. با شناخت رفتار این رویداد، می توانید نمایش وضعیت بارگذاری را مدیریت کنید و از اجرای زودهنگام یا تکراری کدها جلوگیری کنید.

این مطلب بخشی از آموزش JQuery است و شیوه استفاده از متد ajaxStop را همراه با مثال های کاربردی، نکات سازگاری و راهکارهای عیب یابی توضیح می دهد. اگر برای توسعه یا بهبود پروژه خود به طراحی سایت نیاز دارید، آشنایی با مدیریت درست درخواست های پس زمینه نیز می تواند به ساخت تجربه کاربری روان تر کمک کند.

⏱️

پایان همه درخواست ها

رویداد زمانی اجرا می شود که هیچ درخواست Ajax سراسری دیگری در حال اجرا نباشد.

🔄

مدیریت بارگذاری

می توانید پس از پایان فعالیت شبکه، پیام یا نشانگر بارگذاری را به روزرسانی کنید.

⚙️

رویداد سراسری

برخلاف callback یک درخواست، این رویداد وضعیت مجموعه درخواست های فعال را بررسی می کند.

۰۱

متد ajaxStop چیست و چه زمانی اجرا می شود؟

متد ajaxStop در jQuery برای ثبت تابعی به کار می رود که هنگام پایان همه درخواست های Ajax سراسری اجرا می شود. بنابراین این رویداد به پایان یک درخواست مشخص وابسته نیست؛ jQuery آن را زمانی منتشر می کند که شمار درخواست های فعال به صفر برسد.

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

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

در استفاده از این رویداد، منظور از «پایان» این نیست که همه درخواست ها حتما موفق بوده اند. پایان یافتن درخواست، چه با پاسخ موفق و چه با خطا، در شمارش فعالیت Ajax اثر دارد. به همین دلیل ajaxStop را باید رویدادی برای تشخیص پایان فعالیت دانست، نه راهی برای بررسی موفقیت پاسخ.

۵ نکته مهم درباره متد ajaxStop در jQuery

۰۲

۱. تفاوت پایان یک درخواست با پایان همه درخواست ها

رویدادهای اختصاصی هر درخواست، مانند success و complete در تنظیمات Ajax، به همان درخواست مربوط هستند. اما ajaxStop در سطح کلی فعالیت های Ajax عمل می کند. به همین علت ممکن است callback یک درخواست اجرا شده باشد، در حالی که درخواست دیگری هنوز در حال دریافت اطلاعات است.

فرض کنید صفحه برای بارگذاری یک پنل، سه درخواست مستقل ارسال می کند. callback هر درخواست در زمان پایان همان درخواست اجرا می شود، اما ajaxStop تا زمان پایان هر سه درخواست منتظر می ماند. این تفاوت برای کنترل یک نشانگر بارگذاری مشترک اهمیت دارد؛ خاموش کردن نشانگر در callback اولین درخواست می تواند این تصور اشتباه را ایجاد کند که همه محتوا آماده است.

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

۰۳

۲. روش پیشنهادی برای ثبت رویداد

در نسخه های جدید jQuery، رویدادهای سراسری Ajax را به document متصل کنید. روش پیشنهادی استفاده از on() است؛ این روش ثبت رویداد را روشن و یکپارچه می کند و در مقایسه با شکل کوتاه قدیمی، انتخاب مناسب تری برای کدهای جدید محسوب می شود.

در نمونه زیر، هنگام پایان تمام درخواست های فعال، متن وضعیت به روز می شود. پیش از اجرای این کد باید jQuery در صفحه بارگذاری شده باشد و عنصر دارای شناسه ajax-status در صفحه وجود داشته باشد.

$(document).on("ajaxStop", function () {
  $("#ajax-status").text("All AJAX requests completed");
});

اگر پروژه قدیمی دارید، ممکن است نمونه هایی با شکل $(document).ajaxStop(handler) ببینید. این شکل کوتاه در نسخه های قدیمی رایج بوده است؛ برای کد تازه، اتصال رویداد با on("ajaxStop", handler) خواناتر است و با الگوی عمومی مدیریت رویدادها هماهنگی دارد.

۰۴

۳. اتصال رویداد باید پیش از ارسال درخواست باشد

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

در سناریوی زیر ابتدا شنونده ثبت می شود و سپس درخواست اطلاعات را آغاز می کند. رویداد ajaxStop بعد از پایان درخواست های سراسری اجرا می شود و پیام وضعیت را تغییر می دهد.

$(function () {
  $(document).on("ajaxStop", function () {
    $("#ajax-status").text("درخواست های فعال پایان یافتند");
  });

  $.ajax({
    url: "/api/items",
    method: "GET"
  });
});

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

۰۵

۴. توجه به درخواست های غیرسراسری

ajaxStop برای درخواست هایی است که در مدیریت سراسری Ajax شرکت می کنند. اگر در تنظیمات یک درخواست، گزینه global: false قرار دهید، آن درخواست در رویدادهای سراسری Ajax دخالت نمی کند؛ بنابراین پایان آن به تنهایی باعث اجرای ajaxStop نخواهد شد.

این گزینه در مواقعی می تواند مفید باشد که نمی خواهید یک درخواست خاص نشانگر عمومی صفحه را فعال کند یا رویدادهای سراسری را تحت تاثیر قرار دهد. در عوض، باید وضعیت آن درخواست را با callbackهای خودش مدیریت کنید. این جداسازی از رفتار غیرمنتظره در صفحه هایی با چند نوع درخواست جلوگیری می کند.

برای نمونه، تصور کنید یک درخواست پس زمینه برای ثبت رویداد تحلیلی ارسال می شود و نباید وضعیت بارگذاری محتوای اصلی را تغییر دهد. اگر آن درخواست به شکل غیرسراسری پیکربندی شود، ajaxStop آن را جزو درخواست های سراسری فعال حساب نمی کند. پس پیش از عیب یابی، تنظیمات هر درخواست را بررسی کنید.

۰۶

۵. از اجرای چندباره handler جلوگیری کنید

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

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

$(document)
  .off("ajaxStop.pageStatus")
  .on("ajaxStop.pageStatus", function () {
    $("#ajax-status").text("بارگذاری پایان یافت");
  });

استفاده از نام فضای رویداد، مانند pageStatus در نمونه، کمک می کند فقط همان handler مدیریت شود و رویدادهای نامرتبط حذف نشوند. از حذف کلی رویدادها بدون بررسی وابستگی های صفحه خودداری کنید؛ ممکن است بخش های دیگر برنامه به شنونده های جداگانه نیاز داشته باشند.

روش استفاده از ajaxStop با یک مثال کامل

۰۷

ساخت نشانگر وضعیت برای چند درخواست

یکی از کاربردهای معمول ajaxStop، مدیریت نشانگر بارگذاری مشترک است. در این الگو، زمان آغاز درخواست ها را می توان با رویداد سراسری شروع Ajax مدیریت کرد و پس از پایان همه درخواست های فعال، نشانگر را پنهان کرد. در این مثال فرض شده است که عنصری با شناسه loading در صفحه وجود دارد.

$(document).on("ajaxStart.pageLoading", function () {
  $("#loading").show();
});

$(document).on("ajaxStop.pageLoading", function () {
  $("#loading").hide();
});

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

در چنین وضعیتی می توانید برای نمایش نشانگر تاخیر کوتاهی در نظر بگیرید و زمان سنج را پس از پایان درخواست ها پاک کنید. همچنین بهتر است وضعیت بارگذاری را برای فناوری های کمکی نیز قابل فهم کنید؛ برای مثال از یک ناحیه وضعیت مناسب استفاده کنید، نه اینکه تنها به تغییر بصری تکیه داشته باشید.

۰۸

چه زمانی ajaxStop انتخاب مناسبی نیست؟

اگر لازم است پس از پایان یک درخواست مشخص، داده های همان درخواست را بررسی کنید، ajaxStop انتخاب مناسبی نیست؛ این رویداد callback دریافت پاسخ نیست و اطلاعات پاسخ را در اختیار handler قرار نمی دهد. برای این نیاز، از callbackهای همان درخواست مانند done()، fail() یا always() استفاده کنید.

همچنین اگر درخواست ها به روش دیگری غیر از Ajax در jQuery انجام می شوند، مانند استفاده از fetch، رویداد ajaxStop به صورت خودکار پایان آن ها را تشخیص نمی دهد. این رویداد فقط فعالیت هایی را دنبال می کند که از سازوکار Ajax سراسری jQuery استفاده می کنند.

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

عیب یابی اجرا نشدن متد ajaxStop

۰۹

بررسی محل اتصال و نوع درخواست

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

خطاهای جاوااسکریپت پیش از محل ثبت رویداد نیز می توانند مانع اجرای کد شوند. کنسول مرورگر را بررسی کنید و مطمئن شوید فایل jQuery پیش از اسکریپت برنامه بارگذاری شده است. اگر handler در فایل جداگانه قرار دارد، ترتیب بارگذاری و اجرای آن را نیز کنترل کنید.

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

۱۰

بررسی انتظار نادرست از رویداد

یکی از برداشت های اشتباه این است که ajaxStop بعد از هر درخواست اجرا می شود. اگر چند درخواست سراسری هم زمان باشند، این رویداد تا پایان آخرین درخواست منتظر می ماند. در نتیجه، ممکن است callback یک درخواست اجرا شود اما handler مربوط به ajaxStop هنوز فراخوانی نشده باشد.

برداشت دیگر این است که ajaxStop فقط پس از پاسخ موفق اجرا می شود. در واقع کاربرد آن تشخیص پایان فعالیت سراسری Ajax است و برای تصمیم گیری درباره موفقیت یا شکست یک درخواست باید وضعیت همان درخواست را جداگانه بررسی کنید. ترکیب این دو نوع مدیریت باعث می شود منطق برنامه روشن تر بماند.

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

مقایسه ajaxStop با روش های دیگر مدیریت درخواست

۱۱

انتخاب رویداد بر اساس نیاز برنامه

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

روش کاربرد اصلی محدوده اثر دسترسی به نتیجه درخواست
ajaxStop واکنش به پایان همه درخواست های سراسری فعالیت Ajax سراسری صفحه خیر
done() پردازش پاسخ موفق یک درخواست یک درخواست مشخص بله
fail() مدیریت خطای یک درخواست یک درخواست مشخص بله، اطلاعات خطا
always() اجرای کد پس از پایان یک درخواست یک درخواست مشخص با توجه به نتیجه

اگر یک فرم فقط یک درخواست ارسال می کند و باید پس از پایان همان درخواست دکمه دوباره فعال شود، استفاده از always() معمولا شفاف تر است. اگر یک نشانگر عمومی باید تا پایان تمام درخواست های سراسری باقی بماند، ajaxStop تناسب بیشتری دارد. این انتخاب را بر پایه دامنه واقعی نیاز انجام دهید.

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

📌

ثبت یک باره

محل اتصال handler را ثابت نگه دارید تا رویداد مشابه چند بار ثبت نشود.

🔍

بررسی global

تنظیم global درخواست را بررسی کنید تا از شرکت آن در رویداد سراسری مطمئن شوید.

🛠️

انتخاب callback درست

برای نتیجه یک درخواست، از callback همان درخواست استفاده کنید.

✅

آزمایش هم زمانی

رفتار چند درخواست فعال را جدا از یک درخواست منفرد آزمایش کنید.

مزایای متد ajaxStop

مدیریت روان تر درخواست ها

برای رابط های مبتنی بر Ajax
۰۱
هماهنگی

تشخیص پایان کلی

پس از پایان درخواست های سراسری فعال اجرا می شود.

۰۲
رابط کاربری

کنترل نشانگر بارگذاری

برای مدیریت نشانگر بارگذاری مشترک مناسب است.

۰۳
سادگی

کاهش تکرار کد

منطق عمومی را از callbackهای تکراری جدا می کند.

۰۴
مدیریت

پوشش درخواست هم زمان

پایان یک درخواست را با پایان همه اشتباه نمی گیرد.

۰۵
خوانایی

کد قابل فهم تر

با on ثبت می شود و از الگوی عمومی رویدادها پیروی می کند.

۱۲

نتیجه گیری: چه زمانی از متد ajaxStop استفاده کنیم؟

متد ajaxStop در jQuery زمانی انتخاب مناسبی است که بخواهید پس از پایان همه درخواست های سراسری Ajax، یک واکنش عمومی انجام دهید. این رویداد برای مدیریت نشانگر مشترک بارگذاری یا به روزرسانی وضعیت کلی صفحه کاربرد دارد، اما نتیجه یک درخواست مشخص را جایگزین نمی کند.

برای استفاده مطمئن، رویداد را با on("ajaxStop", handler) به document متصل کنید، ثبت handler را پیش از آغاز درخواست ها انجام دهید و تنظیم global را بررسی کنید. اگر لازم است پاسخ یا خطای یک درخواست را مدیریت کنید، از callbackهای همان درخواست کمک بگیرید.

در نهایت، انتخاب درست به دامنه کاری مورد نظر بستگی دارد: ajaxStop برای پایان فعالیت سراسری است و callbackهای درخواست برای نتیجه همان درخواست. رعایت این تفاوت، همراه با مدیریت درست اتصال رویداد، کدی خواناتر و تجربه ای قابل پیش بینی تر برای کاربر ایجاد می کند.

نکته توضیح کوتاه درجه اهمیت
دامنه رویداد پایان همه درخواست های سراسری فعال را تشخیص می دهد. زیاد
روش اتصال برای کد جدید از on و document استفاده کنید. زیاد
درخواست غیرسراسری درخواست دارای global: false در رویداد سراسری شرکت نمی کند. زیاد
نتیجه درخواست برای موفقیت یا خطای یک درخواست، callback اختصاصی به کار ببرید. متوسط
اتصال تکراری از ثبت چندباره handler در چرخه اجرای صفحه جلوگیری کنید. متوسط

سوالات متداول متد ajaxStop در jQuery

متد ajaxStop در jQuery دقیقا چه کاری انجام می دهد؟

این رویداد پس از پایان همه درخواست های Ajax سراسری فعال اجرا می شود. از آن می توانید برای کارهای عمومی مانند پنهان کردن نشانگر بارگذاری استفاده کنید؛ اما برای دریافت پاسخ یا تشخیص نتیجه یک درخواست خاص باید از callbackهای همان درخواست کمک بگیرید.

آیا ajaxStop بعد از هر درخواست اجرا می شود؟

خیر. اگر چند درخواست سراسری هم زمان باشند، ajaxStop تا زمانی که همه آن ها پایان نیافته اند اجرا نمی شود. برای واکنش به پایان یک درخواست مشخص، callbackهایی مانند done یا always مناسب تر هستند.

چطور ajaxStop را در نسخه های جدید jQuery ثبت کنیم؟

رویداد را به document متصل کنید و از on استفاده کنید؛ برای نمونه، $(document).on("ajaxStop", handler);. بهتر است handler پیش از آغاز درخواست های مورد نظر ثبت شود تا رویداد را از دست ندهد.

چرا ajaxStop برای یک درخواست اجرا نمی شود؟

بررسی کنید درخواست با jQuery Ajax ارسال شده باشد، handler پیش از آن ثبت شده باشد و گزینه global روی false تنظیم نشده باشد. همچنین ممکن است درخواست سراسری دیگری هنوز فعال باشد و به همین دلیل رویداد پایانی اجرا نشده باشد.

تفاوت ajaxStop با always چیست؟

ajaxStop به پایان همه درخواست های سراسری فعال واکنش نشان می دهد، اما always به پایان یک درخواست مشخص وابسته است. برای مدیریت وضعیت کلی صفحه از ajaxStop و برای انجام کاری پس از پایان یک درخواست معین از always استفاده کنید.

مدیریت دقیق تر درخواست های Ajax را شروع کنید

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

اطلاعات بیشتر درباره طراحی سایت ←
ارسال نظر و نظرات ثبت شده
سایر مقالات
متد serializeArray ۵ نکته مهم درباره متد serializeArray در jQuery 💡آشنایی با متد در این بخش از آموزش JQuery، ب ...
متد serialize متد serialize در jQuery چیست و چگونه از آن استفاده کنیم؟ ⭐ آشنایی با serialize در این بخش از ...
متد $.post متد post در jQuery چیست و چگونه از آن استفاده کنیم؟ ⭐ آشنایی با درخواست POST در این راهنما، ...
متد load متد load در jQuery چیست و چگونه استفاده می‌شود؟ ⭐ متد load در jQuery متد load در jQuery ...
متد $.getScript آموزش jQuery متد getScript در jQuery؛ دریافت و اجرای فایل جاوااسکریپت نحوه استفاده، پارامت ...
متد $.getJSON آموزش جی کوئری متد $.getJSON در جی کوئری؛ آموزش دریافت داده های JSON نحوه استفاده، مدیریت ...
متد $.get آموزش jQuery آموزش متد $.get در jQuery؛ دریافت اطلاعات از سرور نحوه ارسال درخواست GET، دری ...
متد ajaxSuccess آموزش jQuery متد ajaxSuccess در jQuery؛ آموزش کاربرد و مثال آشنایی با رویداد موفقیت درخواس ...
متد ajaxStop آموزش jQuery متد ajaxStop در jQuery تشخیص پایان همه درخواست های هم زمان Ajax و اجرای کد من ...
متد ajaxStart آموزش jQuery متد ajaxStart در jQuery؛ آموزش کاربرد و مثال اجرای تابع هنگام آغاز درخواست&zw ...
متد $.ajaxSetup آموزش jQuery و Ajax متد ajaxSetup در jQuery: تنظیم پیش فرض درخواست های Ajax نحوه کار، نمون ...
متد ajaxSend آموزش jQuery متد ajaxSend در jQuery چیست و چگونه از آن استفاده کنیم؟ آشنایی با رویداد ارسا ...
متد ajaxError آموزش jQuery متد ajaxError در jQuery؛ مدیریت خطای درخواست Ajax نحوه کار، آرگومان‌ها، ...
متد ajaxComplete آموزش jQuery متد ajaxComplete در jQuery بررسی کاربرد، پارامترها، مثال عملی و نکات مهم روید ...
متد ajax آموزش jQuery متد Ajax در jQuery؛ راهنمای ارسال درخواست به سرور آشنایی با ساختار درخواست Aj ...
متد Get و Post ای جکس در جی کوئری آموزش jQuery Ajax متدهای GET و POST در jQuery Ajax انتخاب متد مناسب، ارسال داده و مدیریت پ ...
Ajax در Jquery چگونه است ؟ Ajax در jQuery چیست و چگونه کار می‌کند؟ 💡آشنایی با ایجکس Ajax در jQuery روشی ساده بر ...
دسته بندی
جستجو
⏳ در حال پردازش...
لطفا صبر کنید