JQuery之$.ajax()方法属性说明

JQuery的 $.ajax() 方法属性老是记不全记不清,用到时老是去搜索,查到的资料各式各样,大多还得要自己过滤下才是自己想要的,太麻烦了,这就抽个空全部整理并理解下。

使用AJAX主要是为了发送异步请求，不需要重新加载整个页面，可以与服务器交互来更新页面部分数据。

示例

下面是一个基本的 JQuery 的 ajax请求：

<script type="text/javascript">
	$(document).ready(function() {
		ajaxRequest();
	});

	function ajaxRequest() {
		var user = {
			realName : '张三',
			account : 'admin',
			password : '112233'
		};

		$.ajax({
			type : 'post',
			url : '/user/ajaxUser',
			dataType : 'json',
			data : {realName : '张小三', account : 'admin', password : '112233'},
			success : function(data) {
				console.log(data);
			}
		});
	}
</script>

属性说明

type

String类型，请求方式(post或get)，默认是 get。

url

String类型，发送请求的URL字符串。

async

Boolean类型，默认设置为true，所有请求均为异步请求。如果需要发送同步请求，请将此选项设置为false。注意，同步请求将锁住浏览器，用户其他操作必须等待请求完成才可以执行。

dataType

String类型，预期服务器返回的数据类型。
如果不指定，jQuery将自动根据HTTP包MIME信息返回responseXML或responseText，并作为回调函数参数传递。
　　xml：返回 XML 文档，可用 JQuery 处理。
　　html：返回纯文本 HTML 信息；包含的 script 标签会在插入 DOM 时执行。
　　script：返回纯文本 JavaScript 代码。不会自动缓存结果。除非设置了 cache 参数。注意在远程请求时（不在同一个域下），所有 post 请求都将转为 get 请求。
　　json：返回　JSON　数据。
　　jsonp：JSONP 格式。使用 SONP 形式调用函数时，例如 **myurl?callback=?**，JQuery将自动替换后一个“ ? ”为正确的函数名，以执行回调函数。
　　text：返回纯文本字符串。

contentType

String类型，发送给服务器的数据格式，即data字段的数据格式。默认为”application/x-www-form-urlencoded”。该默认值适合大多数应用场合。

data

发送到服务器的数据。将自动转换为请求字符串格式。GET 请求中将附加在 URL 后。
必须为 Key/Value 格式。如果为数组，jQuery 将自动为不同值对应同一个名称。如 {foo:['bar1', 'bar2']} 转换为 "&foo=bar1&foo=bar2"。

success

Function类型的参数，请求成功后调用的回调函数。参数：由服务器返回，并根据dataType参数进行处理后的数据；描述状态的字符串。

error

要求为Function类型的参数，请求失败时被调用的函数。

timeout

要求为Number类型的参数，设置请求超时时间（毫秒）。此设置将覆盖$.ajaxSetup()方法的全局设置。

cache

Boolean类型，默认为true（当dataType为script时，默认为false），设置为false将不会从浏览器缓存中加载请求信息。

更多请查看 jQuery手册中的 Ajax用法
参考：$.ajax()方法详解