Latest web development tutorials
 

jQuery pageloadfailed Event

< jQuery Mobile Events

Example

Alert some text when the page load request fails:

$(document).on("pageloadfailed",function(){
  alert("Sorry, requested page does not exist.");
});
Try it Yourself »

Definition and Usage

The pageloadfailed event was deprecated in jQuery version 1.4.0. Use the pagecontainerloadfailed event instead.

The pageloadfailed event is triggered if the page load request fails.

Related events:

  • pagebeforeload - triggered before any load request is made
  • pageload - triggered after the page has been successfully loaded and inserted into the DOM.

Note: These events are used for external pages - Whenever an external page is loaded into the DOM, 2 events are fired. The first is pagebeforeload. The 2nd event will either be pageload or pageloadfailed.

Syntax

$("document").on("pageloadfailed",function(event,data){...})

Parameter Description
function(event,data) Required. Specifies the function to run when the pageloadfailed event occurs.

The function has two optional parameters:

The event object - which can contain any jQuery event properties (e.g. event.target, event.type, etc.) See jQuery Events Reference for more information

The data object - contains the following:

  • url (string) - contains the absolute or relative URL of the page (that was sent to $.mobile.loadPage())
  • absUrl (string) - contains the absolute reference of the URL
  • dataUrl (string) - contains the URL of the browser's location
  • deferred (object) - contains resolve() or reject()
  • options (object) - contains the options that were sent to $.mobile.loadPage()
  • xhr (object) - contains the XMLHttpRequest object (Sent as the 3rd argument to $.ajax() success callback)
  • textStatus (string or null) - contains the status of the request ("success" or "null") (Sent as the 2nd argument to $.ajax() error callback)
  • errorThrown - (null, string, object) - When an HTTP error occurs, errorThrown receives the text of the HTTP status, such as "Not Found" or "Internal Server Error (sent as the 3rd argument to $.ajax() error callback)

Try it Yourself - Examples

A demonstration of related events
A demonstration of pageload and pageloadfailed.

The event object
Using the event.type property to return the triggered event type.

The data object
Using data.url to return the URL of the unsuccessful page load.

The data object
Using data.errorThrown to return some text when a page is not found.

< jQuery Mobile Events