Fetch API

Fetch API

XMLHttpRequest的问题

  1. 所有的功能全部集中在同一个对象上,容易写出不易维护的代码
  2. 采用传统的事件驱动模式,无法适配新的Promise API

Fetch API的特点

  1. 并非取代AJAX,而是对AJAX的一种改进
  2. 精细的功能分割:头部信息,请求信息,响应信息等均分布到不同的对象,更利于处理各种复杂的AJAX场景
  3. 使用了Promise API,更利于异步代码的书写
  4. Fetch API不是ES6的内容,而是HTML5新增的web API
  5. 需要有网络通信的知识

基本使用

请求测试地址:http://api.kuanglinfeng.com

使用fetch函数即可向服务器发送网络请求

  async function getList() {
    const url = 'http://api.kuanglinfeng.com'
    const config = {
      method: 'GET',
      headers: {
        "Content-Type": "application/json",
        // mode: 'no-cors'
      }
    }
    const data = await fetch(url, config).then(response => {
      return response.json()
    })
    console.log(data)
  }

  const button = document.querySelector('button')

  button.addEventListener('click', async () => {
    await getList()
  })

参数

该函数有两个参数:

  1. 必填,字符串,请求地址
  2. 选填,对象,请求配置

参数2(请求配置对象)的属性:

  • method:字符串,请求方法,默认值GET
  • headers:对象,请求头信息
  • body:请求体的内容,必须匹配请求头中的Content-Type
  • mode:字符串,请求模式
    • cors:默认值,配置为该值,会在请求头中加入origin和referer
    • no-cors:配置为该值,不会在请求头中加入origin和referer,跨域的时候可能会出现问题
    • same-origin:指示请求必须在同一个域中发生,如果请求其它域,则会报错
  • credentials:如何携带凭据(cookie)
    • omit:默认值,不携带cookie
    • same-origin:请求同源地址时携带cookie
    • include:请求任何地址都携带cookie
  • cache:配置缓存模式
    • default:表示fetch请求之前将检查下http缓存
    • no-store:表示fetch请求将完全忽略http缓存的存在,这意味着请求之前将不再检查下http的缓存,拿到响应后,它也不会更新http缓存
    • no-cache:如果存在缓存,那么fetch将发送一个条件查询request和一个正常的request,拿到响应后会更新http缓存
    • reload:表示fetch请求之前将忽略http缓存的存在,但是请求拿到响应后,它将主动更新http缓存
    • force-cache:表示fetch请求不顾一切的依赖缓存,即使缓存过期了,它依然从缓存读取,除非没有任何缓存,那么它将发送一个正常的request
    • only-if-cached:表示fetch请求不顾一切的依赖缓存,即使缓存过期了,依旧从缓存中读取,如果没有缓存,将抛出网络错误(该设置只在mode为same-origin有效)

返回值

fetch函数返回一个Promise对象

  • 当收到服务器的返回结果后,Promise进入resolve状态,状态数据为Response对象
  • 当网络发生错误(或其它导致无法完成交互的错误)时,Promise进入reject状态,状态数据为错误信息

Response对象

  • ok:boolean,当响应码在200-299之间为true,其它为false
  • status:number,响应的状态码
  • text():用于处理文本格式的Ajax响应,它从响应中获取文本流,将其读完,然后返回一个被resolve为string对象的Promise
  • blob():用于处理二进制文件格式(图片、电子表格等)的Ajax响应,它读取文件的原始数据,一旦读取完整个文件,就返回一个被resolve为blob对象的Promise
  • json():用于处理JSON格式的Ajax响应,它将JSON数据流转换为一个被resolve为JavaScript对象的Promise
  • redirect():可以用于重定向到另一个URL,它会创建一个新的Promise,resolve来自重定向的URL的响应

Request对象

除了Fetch API上面的基本用法外(实际fetch内部会帮你创建Request对象),还可以通过创建一个Request对象来完成请求

  async function getList() {
    const url = 'http://api.kuanglinfeng.com'
    const config = {
      method: 'GET',
      headers: {
        "Content-Type": "application/json",
        // mode: 'no-cors'
      }
    }
    // 创建Request对象
    const request = new Request(url, config)
    const data = await fetch(request).then(response => {
      return response.json()
    })
    console.log(data)
  }

  const button = document.querySelector('button')

  button.addEventListener('click', async () => {
    await getList()
  })

注意:尽量保证每次请求都是一个新的Request对象

Headers对象

在Request和Response对象内部,会将传递的请求头对象,转换为Headers

Headers对象中的方法:

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