JQuery中$.ajax()方法参数详解及应用


Posted in Javascript onDecember 12, 2013

url: 要求为String类型的参数,(默认为当前页地址)发送请求的地址。

type: 要求为String类型的参数,请求方式(post或get)默认为get。注意其他http请求方法,例如put和

delete也可以使用,但仅部分浏览器支持。

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

置。

async:要求为Boolean类型的参数,默认设置为true,所有请求均为异步请求。

如果需要发送同步请求,请将此选项设置为false。注意,同步请求将锁住浏览器,用户其他操作必须等

待请求完成才可以执行。

cache:要求为Boolean类型的参数,默认为true(当dataType为script时,默认为false)。

设置为false将不会从浏览器缓存中加载请求信息。

data: 要求为Object或String类型的参数,发送到服务器的数据。如果已经不是字符串,将自动转换为字符串格

式。get请求中将附加在url后。防止这种自动转换,可以查看processData选项。对象必须为key/value格

式,例如{foo1:"bar1",foo2:"bar2"}转换为&foo1=bar1&foo2=bar2。如果是数组,JQuery将自动为不同

值对应同一个名称。例如{foo:["bar1","bar2"]}转换为&foo=bar1&foo=bar2。

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:返回纯文本字符串。

beforeSend:要求为Function类型的参数,发送请求前可以修改XMLHttpRequest对象的函数,例如添加自定义

HTTP头。在beforeSend中如果返回false可以取消本次ajax请求。XMLHttpRequest对象是惟一的参

数。

function(XMLHttpRequest){

this; //调用本次ajax请求时传递的options参数

}

complete:要求为Function类型的参数,请求完成后调用的回调函数(请求成功或失败时均调用)。

参数:XMLHttpRequest对象和一个描述成功请求类型的字符串。

function(XMLHttpRequest, textStatus){

this; //调用本次ajax请求时传递的options参数

}

success:要求为Function类型的参数,请求成功后调用的回调函数,有两个参数。

(1)由服务器返回,并根据dataType参数进行处理后的数据。

(2)描述状态的字符串。

function(data, textStatus){

//data可能是xmlDoc、jsonObj、html、text等等

this; //调用本次ajax请求时传递的options参数

error:要求为Function类型的参数,请求失败时被调用的函数。该函数有3个参数,即XMLHttpRequest对象、错

误信息、捕获的错误对象(可选)。

ajax事件函数如下:

function(XMLHttpRequest, textStatus, errorThrown){

//通常情况下textStatus和errorThrown只有其中一个包含信息

this; //调用本次ajax请求时传递的options参数

}

contentType:要求为String类型的参数,当发送信息至服务器时,内容编码类型默认

为"application/x-www-form-urlencoded"。该默认值适合大多数应用场合。

dataFilter:要求为Function类型的参数,给Ajax返回的原始数据进行预处理的函数。

提供data和type两个参数。data是Ajax返回的原始数据,type是调用jQuery.ajax时提供的

dataType参数。函数返回的值将由jQuery进一步处理。

function(data, type){

//返回处理后的数据

return data;

}

global:要求为Boolean类型的参数,默认为true。表示是否触发全局ajax事件。设置为false将不会触发全局

ajax事件,ajaxStart或ajaxStop可用于控制各种ajax事件。

ifModified:要求为Boolean类型的参数,默认为false。仅在服务器数据改变时获取新数据。

服务器数据改变判断的依据是Last-Modified头信息。默认值是false,即忽略头信息。

jsonp:要求为String类型的参数,在一个jsonp请求中重写回调函数的名字。

该值用来替代在"callback=?"这种GET或POST请求中URL参数里的"callback"部分,例如

{jsonp:'onJsonPLoad'}会导致将"onJsonPLoad=?"传给服务器。

username:要求为String类型的参数,用于响应HTTP访问认证请求的用户名。

password:要求为String类型的参数,用于响应HTTP访问认证请求的密码。

processData:要求为Boolean类型的参数,默认为true。默认情况下,发送的数据将被转换为对象(从技术角度

来讲并非字符串)以配合默认内容类型"application/x-www-form-urlencoded"。如果要发送DOM

树信息或者其他不希望转换的信息,请设置为false。

scriptCharset:要求为String类型的参数,只有当请求时dataType为"jsonp"或者"script",并且type是GET时

才会用于强制修改字符集(charset)。通常在本地和远程的内容编码不同时使用。

案例代码:

$(function(){ $('#send').click(function(){ 
$.ajax({ 
type: "GET", 
url: "test.json", 
data: {username:$("#username").val(), content:$("#content").val()}, 
dataType: "json", 
success: function(data){ 
$('#resText').empty(); //清空resText里面的所有内容 
var html = ''; 
$.each(data, function(commentIndex, comment){ 
html += '<div class="comment"><h6>' + comment['username'] 
+ ':</h6><p class="para"' + comment['content'] 
+ '</p></div>'; 
}); 
$('#resText').html(html); 
} 
}); 
}); 
});

顺便说一下$.each()函数:

$.each()函数不同于JQuery对象的each()方法,它是一个全局函数,不操作JQuery对象,而是以一个数组或者对象作为第1个参数,以一个回调函数作为第2个参数。回调函数拥有两个参数:第1个为对象的成员或数组的索引,第2个为对应变量或内容。

Javascript 相关文章推荐
jquery随机展示头像代码
Dec 21 Javascript
javaScript中定义类或对象的五种方式总结
Dec 04 Javascript
Bootstrap Table使用整理(一)
Jun 09 Javascript
ionic2懒加载配置详解
Sep 01 Javascript
javascript原生封装一个淡入淡出效果的函数测试实例代码
Mar 19 Javascript
使用vue-router完成简单导航功能【推荐】
Jun 28 Javascript
深入理解JavaScript的值传递和引用传递
Oct 24 Javascript
JS实现textarea通过换行或者回车把多行数字分割成数组并且去掉数组中空的值
Oct 29 Javascript
详解在网页上通过JS实现文本的语音朗读
Mar 28 Javascript
javascript中call,apply,callee,caller用法实例分析
Jul 24 Javascript
解决一个微信号同时支持多个环境网页授权问题
Aug 07 Javascript
Vue单文件组件开发实现过程详解
Jul 30 Javascript
js setTimeout()函数介绍及应用以倒计时为例
Dec 12 #Javascript
jquery如何获取复选框的值
Dec 12 #Javascript
Jquery创建一个层当鼠标移动到层上面不消失效果
Dec 12 #Javascript
jQuery的each终止或跳过示例代码
Dec 12 #Javascript
javascript字符串替换及字符串分割示例代码
Dec 12 #Javascript
js使下拉列表框可编辑不止是选择
Dec 12 #Javascript
深入理解JavaScript是如何实现继承的
Dec 12 #Javascript
You might like
PHP怎样调用MSSQL的存储过程
2006/10/09 PHP
深入了解php4(1)--回到未来
2006/10/09 PHP
php使用curl访问https示例分享
2014/01/17 PHP
php使用session二维数组实例
2014/11/06 PHP
作为程序员必知的16个最佳PHP库
2015/12/09 PHP
PHP中header用法小结
2016/05/23 PHP
Notify - 基于jquery的消息通知插件
2011/10/18 Javascript
详解javascript事件冒泡
2016/01/09 Javascript
动态更新highcharts数据的实现方法
2016/05/28 Javascript
javascript将中国数字格式转换成欧式数字格式的简单实例
2016/08/02 Javascript
jquery配合.NET实现点击指定绑定数据并且能够一键下载
2016/10/28 Javascript
AngularJS 应用身份认证的技巧总结
2016/11/07 Javascript
JavaScript数组复制详解
2017/02/02 Javascript
JavaScript变量类型以及变量作用域详解
2017/08/14 Javascript
Vue中正确使用jQuery的方法
2017/10/30 jQuery
浅谈React碰到v-if
2018/11/04 Javascript
详解React中合并单元格的正确写法
2019/01/08 Javascript
微信小程序实现点击效果
2019/06/21 Javascript
H5实现手机拍照和选择上传功能
2019/12/18 Javascript
详细介绍解决vue和jsp结合的方法
2020/02/06 Javascript
Vue 集成 PDF.js 实现 PDF 预览和添加水印的步骤
2021/01/22 Vue.js
Python中的数据对象持久化存储模块pickle的使用示例
2016/03/03 Python
Python3 sys.argv[ ]用法详解
2019/10/24 Python
CSS3近阶段篇之酷炫的3D旋转透视
2016/04/28 HTML / CSS
HTML5实现获取地理位置信息并定位功能
2015/04/25 HTML / CSS
html5将图片转换成base64的实例代码
2016/09/21 HTML / CSS
澳大利亚最好的电动自行车:Leon Cycle
2020/12/19 全球购物
Windows和Linux动态库应用异同
2016/04/17 面试题
什么是岗位职责
2013/11/12 职场文书
技能竞赛活动方案
2014/02/21 职场文书
《地震中的父与子》教学反思
2014/04/10 职场文书
人事任命书怎么写
2014/06/05 职场文书
奖学金感谢信
2015/01/21 职场文书
停电调休通知
2015/04/16 职场文书
python利用while求100内的整数和方式
2021/11/07 Python
oracle delete误删除表数据后如何恢复
2022/06/28 Oracle