jquery ajax 请求参数及使用示例

jquery ajax请求参数和回调函数

---

（一）常用参数

参数	类型	默认值	备注
url	String	当前页地址	发送请求的地址
type	String	“GET”	请求方式 (“POST” 或 “GET”)
data	String		发送到服务器的数据。
async	Boolean	true	1. 默认设置下，所有请求均为异步请求。 2.如果需要发送同步请求，请将此选项设置为 false
cache	Boolean	true	1. dataType 为 script 和 jsonp 时默认为 false。 2. 设置为 false 将不缓存此页面。
contentType	String	“application/x-www-form-urlencoded”	1. 发送信息至服务器时内容编码类型。 2.如果你明确地传递了一个 content-type 给 $.ajax() 那么它必定会发送给服务器（即使没有数据要发送）。
processData	Boolean	true	是否处理通过data选项传递进来的数据

（二）常用回调函数

回调函数	默认值	备注
success		请求成功后的回调函数。
error	自动判断 (xml 或 html)	请求失败时调用此函数。

使用示例：

    function upload() {

        //请求参数
        var data = {};
        var send_data = JSON.stringify(data);

        $.ajax({
            //请求URL
            url: 'http://127.0.0.1:5000/upload',
            //请求方式,'POST'和'GET',这里是'POST'
            type: 'POST',
            //数据,json格式
            data: send_data,
            //将异步设置为false,将锁住浏览器，用户其它操作必须等待请求完成才可以执行
            async: false,
            //设置为 false 将不缓存此页面
            cache: false,
            //发送信息至服务器时内容编码类型。
            contentType: "application/json;charset=UTF-8",
            //请求成功后的回调函数。
            success: function(returndata) {
                alert(returndata);
            },
            //请求失败时调用此函数
            error: function(error) {
                alert(error);
            }
        });
    }

（三）其他参数

参数	类型	默认值	备注
context	Object		这个对象用于设置 Ajax 相关回调函数的上下文。
dataType	String		预期服务器返回的数据类型。
global	Boolean	true	是否触发全局 AJAX 事件
ifModified	Boolean	false	仅在服务器数据改变时获取新数据。
jsonp	String		在一个 jsonp 请求中重写回调函数的名字
jsonpCallback	String		为 jsonp 请求指定一个回调函数名。
password	String		用于响应 HTTP 访问认证请求的密码
scriptCharset	String		通常只在本地和远程的内容编码不同时使用。
traditional	Boolean		用传统的方式来序列化数据
timeout	Number		设置请求超时时间（毫秒）
username	String		用于响应 HTTP 访问认证请求的用户名

（四）其他回调函数

回调函数	备注
beforeSend(XHR)	1. 发送请求前可修改 XMLHttpRequest 对象的函数，如添加自定义 HTTP 头。 2. XMLHttpRequest 对象是唯一的参数。这是一个 Ajax 事件。如果返回 false 可以取消本次 ajax 请求。
complete(XHR, TS)	1.请求完成后回调函数 (请求成功或失败之后均调用)。 2.参数： XMLHttpRequest 对象和一个描述请求类型的字符串。3.这是一个 Ajax 事件。
dataFilter	请求成功之后调用；返回新的数据传递给 success 回调函数。
complete	1. 当请求完成之后调用这个函数，无论成功或失败。 2. 传入 XMLHttpRequest 对象，以及一个包含成功或错误代码的字符串。

（五）备注

回调函数：请求完成时执行的函数，格式为：function(response,status,xhr)

其中：

• response - 包含来自请求的结果数据
• status - 包含请求的状态（“success”, “notmodified”, “error”, “timeout” 或 “parsererror”）
• xhr - 包含 XMLHttpRequest 对象