from the jquery documentation:
error(XMLHttpRequest, textStatus, errorThrown)Function
A function to be called if the request fails. The function is passed three arguments: The XMLHttpRequest object, a string describing the type of error that occurred and an optional exception object, if one occurred. Possible values for the second argument (besides null) are "timeout", "error", "notmodified" and "parsererror". This is an Ajax Event.
When you indicate just one parameter, it will be the xmlHttpRequestObject. You can get some good information from that. Sadly, most documentation out there doesn't have you set this up correctly. A good default template is:
error:function (xhRequest, ErrorText, thrownError)
Some good info you can get from xhRequest are:
- .status
: 404: "not found", 500: "server error" This can sometimes be a big help.
- .responseText
is information from the server, often useless in the case of an error but sometimes be helpful
The second value, a string, is sometimes helpful. Ah, I guess the possible values are mentioned in the documentation.
The 3rd parameter, whenever I check it out, has always been undefined. I don't think it's ever useful.