ajax/1.5/ajax

本模块提供Promise化的异步请求接口。

getScript ( src , [options] )

加载脚本文件。

参数:

srcString
文件URL。
[options]Object
其他选项。
[options.data]Object
发送的数据。
[options.nocache=false]Boolean
是否在URL中添加时间戳(参数名为“_”)防止缓存。
[options.charset]String
文件编码。
[options.timeout]Number|String
超时时间,可传入数字(毫秒)或timespan模块支持的格式。
[options.receiveCancel]Function(abort)
接收放弃请求方法的函数。

返回值:

Object加载脚本文件的promise。

jsonp ( src , [options] )

发送JSONP请求。

参数:

srcString
请求地址。
[options]Object
其他选项。
[options.method='GET']String
请求方式,GET或POST。
[options.data]Object
发送的数据。
[options.callbackName]String
回调函数名,如不指定则按照特定规则生成。
[options.nocache=false]Boolean
是否在URL中添加时间戳(参数名为“_”)防止缓存。 请求方式为POST时忽略此参数。
[options.charset]String
编码。请求方式为POST时忽略此参数。
[options.timeout]Number|String
超时时间,可传入数字(毫秒)或timespan模块支持的格式。
[options.receiveCancel]Function(abort)
接收放弃请求方法的函数。

返回值:

Promise加载JSONP的promise。

getImage ( src , [options] )

请求图片。

参数:

srcString
图片URL。
[options]Object
其他选项。
[options.data]Object
发送的数据。
[options.nocache=false]Boolean
是否在URL中添加时间戳(参数名为“_”)防止缓存。

返回值:

Promise加载图片的promise。

createXHR ( )

创建XMLHttpRequest对象。

返回值:

XMLHttpRequestXMLHttpRequest对象。

send ( [url] , [options] )

发送AJAX请求。

参数:

[url]String
请求URL。此参数也可以作为options参数的属性。
[options]Object
其他选项。
[options.url]String
请求URL。
[options.data]Object
发送的数据。
[options.responseType]String
返回的数据格式:json、jsonp、xml或text。 默认根据响应头的Content-Type自动识别。
[options.requestType='form']String
请求的数据格式:form或json。 responseType为jsonp时或method为GET、DELETE时无效。
[options.method='GET']String
请求方式:GET、POST、PUT或DELETE。
[options.nocache=false]Boolean
是否在URL中添加时间戳(参数名为“_”)防止缓存。
[options.headers]Object
要设置的HTTP头,responseType为jsonp时无效。
[options.timeout]Number|String
超时时间,仅在异步请求时有效,可传入数字(毫秒)或timespan模块支持的格式。
[options.withCredentials]Boolean
是否在跨域请求中发送凭据(cookie等)。
[options.async=true]Boolean
是否使用异步方式请求,responseType为jsonp时只能为true。
[options.beforeSend]Function(xhr)
发送请求前执行的回调函数,responseType为jsonp时无效。
[options.receiveCancel]Function(abort)
接收放弃请求方法的函数。
[options.callbackName]String
jsonp回调函数名,如不指定则按照特定规则生成。 仅当responseType为jsonp时有效。

返回值:

Promise发送请求的promise。

serializeForm ( form )

获取表单数据。

参数:

formNodeList|Element
表单。

返回值:

Object<key,value>表单数据。