dataType
is provided, but can be null
in that case.
dataType
Type: String
The type of data expected from the server. Default: Intelligent Guess (xml, json, script, text, html).
url
are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. Type will automatically be set to POST
.
This is a shorthand Ajax function, which is equivalent to:
1
2
3
4
5
6
7
|
|
success
callback function is passed the returned data, which will be an XML root element or a text string depending on the MIME type of the response. It is also passed the text status of the response.
As of jQuery 1.5, the success
callback function is also passed a "jqXHR" object (injQuery 1.4, it was passed the XMLHttpRequest
object).
Most implementations will specify a success handler:
1
2
3
|
|
POST
are never cached, so the cache
and ifMod
ified
options in jQuery.ajaxSetu
p()
have no effect on these requests.
XMLHTTPRequest
object. This jQuery XHR object, or "jqXHR," returned by $.post()
implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done()
(for success), jqXHR.fail()
(for error), and jqXHR.always()
(for completion, whether success or error; added in jQuery 1.6) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax()
documentation.
The Promise interface also allows jQuery's Ajax methods, including $.get()
, to chain multiple .d
one()
, .fail()
, and .always()
callbacks on a single request, and even to assign these callbacks after the request may have completed. If the request is already complete, the callback is fired immediately.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
|
jqXHR.success()
, jqXHR.error
()
, and jqXHR.complete()
callback methods are removed as of jQuery 3.0. You can use jqXHR.done()
, jqXHR.fail()
, and jqXHR.always()
instead.
aj
axError
event. Alternatively, as of jQuery 1.5, the .error()
method of the jqXHR
object returned by jQuery.post() is also available for error handling.
1
|
|
1
|
|
1
|
|
1
|
|
1
2
3
|
|
1
2
3
4
|
|
1
2
3
4
|
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
|