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>表单数据。