核心提示:$.ajax()参数解析 参数名称 类型 说明 url String (默认当前页地址)发送请求的地址 type String 请求方式(一般为post或get)默认get. ...
$.ajax()参数解析
参数名称 | 类型 | 说明 |
---|---|---|
url | String | (默认当前页地址)发送请求的地址 |
type | String | 请求方式(一般为post或get)默认get. |
timeout | Number | 设置请求超时时间(毫秒)。会覆盖$.ajaxSetup()方法的全局设置 |
async | Boolean | 默认为true。所以请求均为异步请求。如需同步请求,设为false,将锁住浏览器,其他操作必须等待请求完成才可以执行 |
cache | Boolean | 默认为true(当dataType为script时,默认为flase)。设置为false将不会从浏览器缓存中加载请求信息。 |
data | Object或String | 发送到服务器的数据。若不是字符串,将自动转为字符串格式。GET请求中附加在url之后,防止自动转换参考processData选项。对象必须为key/value格式。例如{fool:”barl”,foo2:”bar2”}转换为&foo1=bar1&foo2=bar2.若是数组,jquery将自动为不同值对应同一个名称。例如{foo:[“bar1”,”bar2”]}转换为&foo=bar1&foo=bar2 |
dataType | String | 服务器返回的数据类型。若不指定,自动根据http包MIME信息返回responseXML或responseText,并作为回调函数参数传递。类型如下:xml/html/script/json/jsonp/text |
beforeSend | Function | 发送请求前可以修改XMLHttpRequest对象的函数。例如添加自动义HTTP头。在函数中返回false可以取消本次ajax请求。XMLHttpRequest对象是唯一的参数。function(XMLHttpRequest){this;//调用本次ajax请求传递的options参数} |
complete | Function | 请求完成后调用的回调函数(请求失败或成功均调用)。参数:XMLHttpRequest对象和描述成功请求类型的字符串。function(XMLHttpRequest,textStatus){this;//调用本次ajax请求传递的options参数} |
success | Function | 请求成功后调用的回调函数。有两个参数。(1)data服务器返回的要进行处理的数据。(2)textStatus。描述状态的字符串。function(data,textStatus){this;//调用本次ajax请求传递的options参数} |
error | Function | 请求失败被调用的函数。3个参数。XMLHttpRequest对象,错误信息,捕获的错误对象(可选)。function(XMLHttpRequest,textStatus,errorThrown){//通常情况下textStatus和errorThrown只有其中一个包含信息 this;//调用本次ajax请求传递的options参数} |
contentType | String | 当发送信息至服务器时,内容编码类型默认为”application/x-www-form-urlencoded”。适合大多数应用场合。 |
dataFilter | Function | 给ajax返回的原始数据进行预处理的函数。两个参数:data和type。data是Ajax返回的原始数据,type是提供的dataType参数。function(data,type){//返回处理后的数据 return data;} |
global | Boolean | 默认为true.表示是否触发全局Ajax事件。设置为false不会触发。AjaxStart或AjaxStop可用于控制各种Ajax事件 |
ifModified | Boolean | 默认为false。仅在服务器数据改变时获取新数据。服务器数据改变判断的依据是Last-Modified头信息。默认值是false,即忽略头信息。 |
jsonp | String | 在一个jsonp请求中重写回调函数的名字。该值用来替代”callback=?”这种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)。通常在本地和远程内容编码不同时使用。 |
$('#send').click(function(){ $.ajax({ type:"POST", url:"test.action", dataType:"json", success:function(data){ ..... }, error:function(){ ..... } }); });