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
Color Picker