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插件 cluetip 关键词注释
Jan 12 Javascript
JavaScript sup方法入门实例(把字符串显示为上标)
Oct 20 Javascript
JavaScript实现的一个倒计时的类
Mar 12 Javascript
JS实现灵巧的下拉导航效果代码
Aug 25 Javascript
JS获取鼠标选中的文字
Aug 10 Javascript
Vue开发过程中遇到的疑惑知识点总结
Jan 20 Javascript
从零学习node.js之mysql数据库的操作(五)
Feb 24 Javascript
JS实现队列的先进先出功能示例
May 10 Javascript
WdatePicker.js时间日期插件的使用方法
Jul 26 Javascript
Vue 实现双向绑定的四种方法
Mar 16 Javascript
jQuery实现文本显示一段时间后隐藏的方法分析
Jun 20 jQuery
JS面向对象实现飞机大战
Aug 26 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木马攻击防御之道
2008/03/24 PHP
PHP合并静态文件详解
2014/11/14 PHP
php搜索文件程序分享
2015/10/30 PHP
PHP构造二叉树算法示例
2017/06/21 PHP
掌握PHP垃圾回收机制详解
2019/03/13 PHP
一个不错的应用,用于提交获取文章内容,不推荐用
2007/03/03 Javascript
javascript jQuery $.post $.ajax用法
2008/07/09 Javascript
JavaScript 对象链式操作测试代码
2010/04/25 Javascript
利用CSS、JavaScript及Ajax实现高效的图片预加载
2013/10/16 Javascript
为指定的元素添加遮罩层的示例代码
2014/01/15 Javascript
jQuery操作元素css样式的三种方法
2014/06/04 Javascript
JS中实现简单Formatter函数示例代码
2014/08/19 Javascript
jquery ui resize 中border-box的bug修正
2015/04/26 Javascript
jQuery页面刷新(局部、全部)问题分析
2016/01/09 Javascript
javascript的几种继承方法介绍
2016/03/22 Javascript
jQuery在ie6下无法设置select选中的解决方法详解
2016/09/20 Javascript
自制微信公众号一键排版工具
2016/09/22 Javascript
在vue-cli的组件模板里使用font-awesome的两种方法
2018/09/28 Javascript
回顾Javascript React基础
2019/06/15 Javascript
python多线程扫描端口示例
2014/01/16 Python
wxPython事件驱动实例详解
2014/09/28 Python
Python DataFrame设置/更改列表字段/元素类型的方法
2018/06/09 Python
python实现对图片进行旋转,放缩,裁剪的功能
2019/08/07 Python
Python+Kepler.gl实现时间轮播地图过程解析
2020/07/20 Python
Matplotlib 折线图plot()所有用法详解
2020/07/28 Python
python Matplotlib数据可视化(2):详解三大容器对象与常用设置
2020/09/30 Python
python操作toml文件的示例代码
2020/11/27 Python
一些Unix笔试题和面试题
2012/09/25 面试题
写好求职信第一句话的技巧
2013/10/26 职场文书
测试工程师岗位职责
2013/11/28 职场文书
西式婚礼证婚词
2014/01/12 职场文书
学校总务处领导班子民主生活会对照检查材料思想汇报
2014/09/27 职场文书
毕业生捐书活动倡议书
2015/04/27 职场文书
导游词之日本富士山
2020/01/06 职场文书
Spring Cache和EhCache实现缓存管理方式
2021/06/15 Java/Android
使用 Docker Compose 构建复杂的多容器App
2022/04/30 Servers