Latest web development tutorials
 

jQuery pagecontainerloadfailed Event

< jQuery Mobile Events

Example

Alert some text when the page load request fails:

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

Definition and Usage

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

Related events:

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

Syntax

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

Parameter Description
function(event,data) Required. Specifies the function to run when the pagecontainerloadfailed 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 pagecontainerload and pagecontainerloadfailed.

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