前端之路——JS之Fetch API

什么是Fetch API

Fetch API提供了一个获取资源的接口,类似于XMLHttpRequest。
Fetch API中最基础的的一个接口是fetch():

let url = 'http://example.com';
fetch(url)
.then(res => res.json())
.catch(error => console.log(error))

除了提供了fetch()这个函数,Fetch API还定义了相应的RequestResponse

API语法

Promise<Response> fetch(input[, init]);

参数

  • input
    定义要获取的资源,可以是:
  1. 字符串,包含要获取资源的 URL
  2. Request对象
  • init
    请求的配置项,可选参数如下:
  1. method: 请求使用的方法,如GETPOST
  2. headers: 请求的头信息,形式为Headers的对象或包含ByteString值的对象字面量。
  3. body: 请求的body信息,可能是一个BlobBufferSourceFormDataURLSearchParams或者USVString对象。
  4. mode: 请求的模式,如corsno-cors或者same-origin
  5. credentials: 请求的credentials,如 omitsame-origin或者include。为了在当前域名内自动发送cookie,必须提供这个选项。
  6. cache: 请求的cache模式: defaultno-storereloadno-cacheforce-cache或者only-if-cached
  7. redirect: 可用的redirect模式: follow(自动重定向),error(如果产生重定向将自动终止并且抛出一个错误), 或者manual(手动处理重定向)。
  8. referrer: 一个USVString可以是no-referrerclient或一个URL。默认是 client

返回值

Promise,resolve时回传Response对象。

异常

  • AbortError:请求被取消
  • TypeError: 如果URL中有用户权限,例如:http://user:password@example.com

ajax()的不同

  • 当服务端返回404或500时,fetch()返回的Promise不会reject,而是会resolve,但是response.ok的值会变成false。当response的状态码是2XX时,response.ok的值会是true。因此,在对response进行处理之前,需要先检查response.ok
  • 默认情况下,fetch()发送请求时不会带上cookies。要发送cookies,必须设置credentials选项,即第二个参数中的{credentials: 'include'}

为什么有了Fetch API

要回答这个问题,首先需要思考的是,没有Fetch API时用的是什么——Ajax,即对XMLHttpRequest的封装。
一般会这样使用XMLHttpRequest:

   var xhr = new XMLHttpRequest();
   xhr.open('GET', url);
   xhr.onreadystatechange = function() {
     if (this.readyState === XMLHttpRequest.DONE) {
       if (this.status === 200) {
         console.log(this.responseText);
       } else {
         console.log('There was a problem with the request.');
       }
     }
   }

或者使用jquery:

  $.ajax({
    url: url,
    method: 'GET',
    success: function(data) {
      console.log(data);
    },
    error: function(error) {
      console.log(error);
    }
  });

而使用fetch()则会是这样:

  fetch(url, {method: 'GET'})
  .then(function(res){console.log(res.json())})
  .catch(function(error){console.log(error)});

从以上示例代码中可以很直观的看出,fetchAPI至少有以下几个优点:

  1. 代码简洁直观。
  2. 可以链式调用。

总结

使用Promise API可以避免“回调地狱”。此外,fetch API对请求和响应都作了规范,使得在配置Request以及消费Response时使用的API更加直观。原生的XMLHttpRequest以及jquery都把所有的配置项揉合在一起,配置起来十分不方便。
当然,Fetch API也有缺陷,不支持取消请求。一旦发起,不能中断,也不会超时,只能等待被 resolve 或 reject。
另外,目前fetchAPI还存在部分兼容性的问题,要在生产环境中使用的话,需要使用ployfill。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,591评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,448评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,823评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,204评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,228评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,190评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,078评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,923评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,334评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,550评论 2 333
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,727评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,428评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,022评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,672评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,826评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,734评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,619评论 2 354

推荐阅读更多精彩内容