[jQuery] $.ajax timeout basics

[jQuery] $.ajax timeout basics


Hi everyone,
I've been using jQuery for a bit of time now, and getting quite
comfortable with it... except something that's been frustrating the
hell out of me all day!
Can anyone explain to me the basics of the ajax timeout function
works? I've tried defining a timeout in the global ajax handler, and
also in my ajax call itself, but I just can't get my ajax call to
stop, and do something once the timeout I set is passed.
Looks like it should be really simple - it probably is - but any help
would be really appreciated.
This is what I have so far;
$.ajax(
     {
url: my_url,
dataType: 'json',
success: function(data){
    ... success code goes here ...
},
timeout: 1000
}
);
So, what gets trigger when the timeout is passed - is it 'error' (if I
define that), is it 'stop' (which I've read elsewhere) or do I need to
define my own handler?
Thanks all,
Oliver