ajaxError()

ajaxError( handler(event, XMLHttpRequest, ajaxOptions, thrownError) )

מחזירה: jQuery

תיאור: מצרף פונקציה, שמופעלת כל פעם אחרי שבקשת Ajax הסתיימה עם שגיאה. זה אירוע Ajax.

ארגומנטים

ajaxError( handler(event, XMLHttpRequest, ajaxOptions, thrownError) )

הוספה בגרסה: 1.0

handler(event, XMLHttpRequest, ajaxOptions, thrownError)

פונקציה

פונקציה להפעלה.

כל פעם שמסתיימת בקשת Ajax עם שגיאה, jQuery מפעיל אירוע ajaxError. כל המטפלי אירועים שנרשמו יחד עם שיטה .ajaxError() יופעלו באותו זמן.

כדי לצפות בשיטה הזאת בפעולה אנחנו יכולים להגדיר בקשת טעינה בסיסית של Ajax:

<div class="trigger">Trigger</div>
<div class="result"></div>
<div class="log"></div>

אנחנו יכולים לצרף מטפל אירועים שלנו לכל אלמנט:

$('.log').ajaxError(function() {
  $(this).text('Triggered ajaxError handler.');
});

עכשיו, אנחנו יכולים לבצע בקשת Ajax באמצעות כל שיטה של jQuery:

$('.trigger').click(function() {
  $('.result').load('ajax/missing.html');
});

כאשר משתמש לוחץ כפתור ובקשת Ajax נכשלה, מכיוון שקובץ בקשה לא נמצא , מוצגת הודעה ב-div עם מחלקה log.

שימו לב: מכיוון ש- .ajaxError() מיושם כשיטה של אובייקט מופעים של jQuery, אנחנו יכולים להשתמש במילת מפתח this, כמו שעשינו כאן, כדי להפנות אלמנטים שנבחרו בתוך פונקציה של קריאה חוזרת.

כל מטפלי אירועים ajaxError מופעלים, ללא קשר איזה בקשה של Ajax הסתיימה. אם אנחנו צריכים להבדיל בין הבקשות, אנחנו יכולים להשתמש בפרמטרים שהועברו למטפל אירועים. כל פעם שמטפל ajaxError מופעל, מועברים אובייקט אירוע, אובייקט XMLHttpRequest, ואובייקט הגדרות שהשתמש בייצירת בקשה. אם בקשה לא הצליחה בגלל ש- JavaScript הציג שגיאה, אובייקט שגיאה מועבר למטפל אירועים כארגומנט הרביעי. לדוגמה, אנחנו יכולים להגביל קריאה חוזרת שלנו רק לאירועי מטפלים קשורים ל- URL הספציפי:

$('.log').ajaxError(function(e, xhr, settings, exception) {
  if (settings.url == 'ajax/missing.html') {
    $(this).text('Triggered ajaxError handler.');
  }
});

דוגמה:

מציג הודעה כשה בקשת Ajax נכשלה.

$("#msg").ajaxError(function(event, request, settings){
   $(this).append("<li>Error requesting page " + settings.url + "</li>");
 });

האם מידע זה היה מועיל?

כן לא

ajaxError()

ajaxError( handler(event, XMLHttpRequest, ajaxOptions, thrownError) )

ארגומנטים

ajaxError( handler(event, XMLHttpRequest, ajaxOptions, thrownError) )

דוגמה:

תגובות