cb fetch
1.10.0
一个真正的跨行和前向兼容的库，用于执行遵循回调模式的异步 HTTP 请求。
npm install --save cb-fetchyarn add cb-fetchjspm install cb-fetchbower install --save cb-fetch< script src = " //cdn.jsdelivr.net/combine/npm/@string/isstring/isString.min.js,npm/cb-fetch/index.min.js " type = " text/javascript " ></ script >
define(function (require) {
var request = require('cb-fetch');
});
var request = require('cb-fetch')['default'];
var request = require('cb-fetch');
YUI({
modules: { 'is-string': 'path/to/@string/isstring.js' }
}).use('is-string', 'cb-fetch', function (Y) {
var request = Y['default'];
});
import request = require('cb-fetch');
如果前面列出的模块注册方法均不受支持，则将公开名为request全局变量。
// here's your typical request
request ( 'http://www.example.com?key1=value1&key2=value2' )
. done ( response => { /* … */ } ) ;
// taking a comprehensive approach is encouraged though
request ( )
. get ( 'http://www.example.com' )
. query ( 'key1=value1&key2=value2' )
. done ( onSuccessCallback , onErrorCallback ) ;
// passing an object offers options not available otherwise
let abort = request ( {
url : new URL ( 'http://www.example.com' ) ,
parameters : new URLSearchParams ( '_csrf=TOKEN' ) ,
mode : 'cors' ,
credentials : 'include' ,
responseType : 'json'
} ) . get ( '/segment' )
. query ( { foo : [ 'bar' , 'qux' ] } )
. pass ( 'Content-Type' , 'application/json' )
. hook ( 'download' , e => { /* … */ } )
. done ( {
success : onSuccessCallback ,
error : onErrorCallback ,
abort : onAbortCallback
} ) ;
// forcefully aborts the request
abort ( ) ; fetchXMLHttpRequestXDomainRequest (Options.url?) => Object
(Options.parameters?) => Object
(Options.body?) => Object
('loadstart', () => Boolean | Void) => Object
('download', Object => Any) => Object
('loadend', () => Any) => Object
{
(name: String, value: String),
(headers: Object | Headers)
} => Object
// assigns
. pass ( new Headers ( { key : 'value' } ) )
// appends
. pass ( { key : 'value' } )
// sets
. pass ( 'key' , 'value' ) {
(onSuccess?: Function, onError?: Function),
({
success?: Function,
error?: Function,
timeout?: Function,
abort?: Function
})
} => () => Void,
throws: TypeError
| 财产 | 默认 | 值 |
|---|---|---|
| 身体 | 无效的 | BufferSource、Blob、Document²、FormData、字符串、URLSearchParams、ReadableStream |
| 证书 | ‘同源’ | “包含”、“省略”⁶、“同源” |
| 标头 | {} | 对象、标题³ |
| 方法 | '得到' | 细绳 |
| 模式 | ‘同源’ | “cors”、“无cors”、“同源” |
| 密码 | 无效的 | 细绳 |
| 参数 | URLSearchParams、对象、字符串 | |
| 响应媒体类型² | 细绳 | |
| 响应类型 | '文本'，'json'，'blob'，'文档'，'arraybuffer'，'formdata'，'moz-blob'，'moz-chunked-arraybuffer'，'moz-chunked-text'，'msxml-文档' | |
| 暂停 | 0 | ℕ |
| 用户名 | 无效的 | 细绳 |
| 网址 | 位置.href | 字符串、网址 |
| 多部分⁷ | 错误的 | 布尔值 |
| 隧道⁵ | 错误的 | 布尔值 |
| XSL模式⁴ | 错误的 | 布尔值 |
| 财产 | 类型 |
|---|---|
| 块 | 字符串、ArrayBuffer、Blob、Uint8Array、null |
| 总计的 | 字符串、ArrayBuffer、Blob、Uint8Array、null |
| 已加载 | ℕ |
| 全部的 | ℕ |
| 长度可计算 | 布尔值 |
| 财产 | 类型 |
|---|---|
| 身体 | 对象、字符串、文档、ArrayBuffer、Blob、FormData、ReadableStream、null |
| 标头 | 目的 |
| 实例 | XMLHttpRequest、XDomainRequest、响应、AnonXMLHttpRequest |
| 状态码 | ℕ |
| 状态文本 | 细绳 |
| 网址 | 细绳 |
1 仅获取
² 仅 XHR
³ 壁虎 34–43 除外
⁴ 仅限 MSXML 3.0
⁵ 方法重写
⁶ 获取、Gecko 16+、Presto/2.10.232–2.12.423
⁷ 壁虎 1.7β–22
delete保留关键字在 ES5 之前的环境中，删除方法需要使用括号表示法。
对于由 Gecko 1.9.1–20 提供支持的浏览器，要将公开的响应标头填充到headers属性中，必须满足以下条件：
Access-Control-Expose-Headers响应标头暴露自身Access-Control-Expose-Headers字段值不是*mode设置为corsXDomainRequest内在限制*或请求文档的确切 URL 的Access-Control-Allow-Origin标头进行响应Internet Explorer 的默认设置限制使用第3 方 cookie，除非已通过自定义 HTTP 响应标头包含 P3P 紧凑策略声明；因此，如果 cookie 被认为不令人满意，则无法完全遵守"include"凭据模式。
