0

0

fetch API的异步数据获取方法

幻夢星雲

幻夢星雲

发布时间:2025-07-13 14:04:02

|

784人浏览过

|

来源于php中文网

原创

fetch api基于promise,提供异步请求能力,替代xmlhttprequest。1. fetch调用后返回promise,解析为response对象,即使http状态码为404或500也不会reject,需手动检查response.ok判断业务成功与否;2. 响应数据需通过response.json()、text()等方法解析,这些方法同样返回promise;3. 错误处理时,网络错误或cors阻止才会触发catch,业务错误需主动抛出并捕获以提供详细提示;4. 使用abortcontroller可实现请求取消与超时控制;5. fetch优势在于代码简洁、支持async/await、默认处理cors及流式响应;6. 优化性能可通过缓存、减少请求、合理并发、加载指示器、预加载和乐观更新等方式提升用户体验。

fetch API的异步数据获取方法

fetch API是现代浏览器中用于异步数据请求的核心工具,它基于Promise,提供了一种更简洁、强大的方式来替代传统的XMLHttpRequest。简单来说,它让你能以非阻塞的方式从服务器获取或发送数据,而不会冻结用户的界面。

fetch API的异步数据获取方法

解决方案

在我看来,掌握fetch API的关键在于理解它如何与Promise协同工作,以及它处理响应的“两段式”结构。当你调用fetch(url, options)时,它立即返回一个Promise。这个Promise在网络请求完成(无论成功还是失败)后会解析成一个Response对象。

这里有个我个人觉得初学者最容易混淆的地方:即使服务器返回了像404(未找到)或500(服务器内部错误)这样的HTTP状态码,fetch的Promise也不会被拒绝(reject)。它只有在网络错误(比如断网)或者请求被阻止(比如CORS策略)时才会reject。这意味着,你需要手动检查Response对象的ok属性(一个布尔值,表示HTTP状态码是否在200-299之间)来判断请求是否“业务成功”。

fetch API的异步数据获取方法

获取到Response对象后,数据本身并不是直接可用的。你需要调用response.json()response.text()response.blob()等方法来解析响应体。这些方法同样返回Promise,因为解析过程也可能是异步的,特别是当数据量很大时。

最常见的用法是结合async/await语法,这让异步代码看起来更像同步代码,可读性大大提升:

fetch API的异步数据获取方法
async function fetchData(url) {
  try {
    const response = await fetch(url);

    // 检查HTTP状态码是否成功
    if (!response.ok) {
      // 抛出错误,让try...catch捕获
      const errorData = await response.json(); // 尝试解析错误信息
      throw new Error(`HTTP error! status: ${response.status}, message: ${errorData.message || '未知错误'}`);
    }

    const data = await response.json(); // 解析JSON数据
    console.log(data);
    return data;
  } catch (error) {
    console.error('获取数据时发生错误:', error);
    // 这里可以进行错误上报或者用户提示
    throw error; // 重新抛出错误,以便上层调用者处理
  }
}

// 调用示例
fetchData('https://api.example.com/data')
  .then(data => {
    // 数据成功获取并处理
  })
  .catch(error => {
    // 错误被捕获
  });

// 发送POST请求的例子
async function postData(url, data) {
  try {
    const response = await fetch(url, {
      method: 'POST', // 或 'PUT', 'DELETE' 等
      headers: {
        'Content-Type': 'application/json',
        // 'Authorization': 'Bearer your_token' // 如果需要认证
      },
      body: JSON.stringify(data) // 将JavaScript对象转换为JSON字符串
    });

    if (!response.ok) {
      const errorText = await response.text();
      throw new Error(`HTTP error! status: ${response.status}, details: ${errorText}`);
    }

    const result = await response.json();
    console.log('POST请求成功:', result);
    return result;
  } catch (error) {
    console.error('POST请求失败:', error);
    throw error;
  }
}

// postData('https://api.example.com/submit', { name: 'Alice', age: 30 });

fetch的第二个参数options对象非常强大,它允许你配置请求方法(method)、请求头(headers)、请求体(body)、缓存模式(cache)、跨域模式(mode)等等。比如,发送JSON数据时,设置headers中的'Content-Type': 'application/json'body: JSON.stringify(data)是必不可少的步骤。

如何优雅地处理Fetch API中的错误和异常?

处理fetch的错误,确实是个需要细心对待的地方,因为它不像XMLHttpRequest那样,HTTP错误码会直接触发onerror。我个人在项目中,通常会采用以下策略来确保错误处理的健壮性:

首先,也是最核心的一点,是在Promise链中或async/awaittry...catch块里,务必检查response.ok属性。如果response.okfalse,那就意味着HTTP状态码不在200-299的成功范围内。这时,我通常会选择手动抛出一个Error对象,这样它就能被后续的.catch()或外层的try...catch块捕获。在抛出错误前,尝试解析响应体来获取服务器返回的错误详情(比如一个包含错误消息的JSON对象),这对于调试和向用户展示具体错误信息非常有帮助。

async function safeFetch(url, options) {
  try {
    const response = await fetch(url, options);

    if (!response.ok) {
      let errorInfo = `HTTP Error: ${response.status} ${response.statusText}`;
      try {
        // 尝试解析JSON错误信息
        const errorBody = await response.json();
        errorInfo += `, Details: ${JSON.stringify(errorBody)}`;
      } catch (parseError) {
        // 如果不是JSON,尝试解析为文本
        const errorText = await response.text();
        errorInfo += `, Details: ${errorText}`;
      }
      throw new Error(errorInfo);
    }

    return response; // 返回原始响应,让调用者决定如何解析
  } catch (networkError) {
    // 捕获网络错误(如断网、CORS阻止等)
    console.error('网络或请求配置错误:', networkError.message);
    throw new Error(`请求失败,请检查网络连接或稍后再试。 (${networkError.message})`);
  }
}

// 使用示例
safeFetch('https://api.example.com/nonexistent')
  .then(response => response.json())
  .then(data => console.log('数据:', data))
  .catch(error => console.error('最终捕获:', error.message));

// 如果需要取消请求,AbortController是你的好朋友
const controller = new AbortController();
const signal = controller.signal;

async function fetchWithTimeout(url, timeout = 5000) {
  const abortTimeoutId = setTimeout(() => controller.abort(), timeout);
  try {
    const response = await fetch(url, { signal });
    clearTimeout(abortTimeoutId); // 请求成功,清除定时器
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    return await response.json();
  } catch (error) {
    clearTimeout(abortTimeoutId); // 发生错误,清除定时器
    if (error.name === 'AbortError') {
      console.warn('请求已取消或超时');
    } else {
      console.error('请求失败:', error);
    }
    throw error;
  }
}

// fetchWithTimeout('https://api.example.com/slow-data', 2000)
//   .then(data => console.log(data))
//   .catch(err => console.error(err.message));
// // 可以在其他地方手动调用 controller.abort() 来取消请求
// // controller.abort();

除了上面提到的,我还会在try...catch块中区分网络错误(TypeError,通常是断网、CORS策略等)和业务逻辑错误(通过response.ok判断后手动抛出的)。对于网络错误,通常会给用户一个通用提示,比如“网络连接失败”;对于业务错误,则可以根据服务器返回的具体信息进行更精准的提示。引入AbortController可以实现请求的取消和超时控制,这对于提升用户体验和资源管理至关重要,比如用户在输入框快速键入时,可以取消之前的搜索请求,只保留最新的。

php中级教程之ajax技术
php中级教程之ajax技术

AJAX即“Asynchronous Javascript And XML”(异步JavaScript和XML),是指一种创建交互式网页应用的网页开发技术。它不是新的编程语言,而是一种使用现有标准的新方法,最大的优点是在不重新加载整个页面的情况下,可以与服务器交换数据并更新部分网页内容,不需要任何浏览器插件,但需要用户允许JavaScript在浏览器上执行。《php中级教程之ajax技术》带你快速

下载

Fetch API与XMLHttpRequest相比,有哪些显著优势和使用场景?

从我个人的开发体验来看,fetch API相对于老旧的XMLHttpRequest(XHR),简直是质的飞跃。最直观的感受就是代码的简洁性和可读性。XHR那套基于事件和回调的模式,很容易导致所谓的“回调地狱”(Callback Hell),尤其是在需要处理多个连续异步操作时,代码层级会变得非常深,难以维护。

fetch则完全拥抱了Promise,这使得它能够与async/await完美结合。这种模式下,你的异步代码看起来和写同步代码几乎一样,大大降低了理解和调试的难度。想象一下,以前你需要监听onloadonerroronprogress等多个事件,而现在,一个.then().catch()(或者try...catch)就能搞定绝大部分情况。

XHR的痛点与Fetch的优势对比:

  • Promise化: fetch原生支持Promise,意味着你可以轻松使用.then().catch()链式调用,或者更现代的async/await语法。XHR则需要手动封装Promise,或者依赖第三方库。
  • API设计更符合现代Web: fetch的API设计更贴近HTTP协议本身,例如,它返回的是一个Response对象,你可以方便地访问各种HTTP头信息、状态码,以及通过不同的方法(json(), text(), blob()等)解析响应体,这比XHR手动解析responseText方便多了。
  • 默认处理跨域(CORS): fetch在处理CORS请求时,默认行为更合理,它会根据服务器的CORS策略自动处理预检请求(preflight requests),而XHR在某些情况下需要手动配置withCredentials等。
  • 流式处理: fetchResponse对象支持ReadableStream,理论上可以实现响应体的流式处理,这对于处理大文件下载或实时数据流有潜在优势(虽然实际应用中还需要配合其他API)。XHR则通常需要等待整个响应体下载完成后才能处理。

Fetch的典型使用场景:

  • 单页应用(SPA)的数据交互: 几乎所有的SPA都会大量使用fetch来与后端API进行数据交换,无论是获取用户列表、商品详情,还是提交表单数据。
  • 构建微服务前端: 当你的前端需要与多个微服务后端进行交互时,fetch的简洁性使得组织和管理这些请求变得更加容易。
  • 文件上传下载: fetch可以很方便地处理FormData对象进行文件上传,或者下载二进制数据(blob())。
  • Web组件或库内部的HTTP请求: 许多现代JavaScript库和框架,比如React、Vue的内部或社区插件,都倾向于使用fetch作为其底层HTTP请求机制。

虽然XHR在某些非常老的浏览器环境中可能仍有兼容性优势,但对于现代Web开发,fetch无疑是首选。它让前端开发者能更专注于业务逻辑,而不是纠缠于复杂的异步回调。

在实际项目中,如何优化Fetch API的性能和用户体验?

在真实的项目里,光是能用fetch发请求还不够,我们还得考虑如何让它跑得更快、用户体验更好。这不仅仅是代码层面的优化,更关乎产品设计和用户心理。

1. 减少不必要的请求: 这是最直接也最有效的优化。

  • 客户端缓存: 对于不经常变动的数据,可以考虑在前端进行缓存。比如,用localStoragesessionStorage存储一些配置数据、字典数据。每次请求前先检查本地是否有缓存,有就直接用,没有再去fetch
  • HTTP缓存: 确保你的后端正确设置了HTTP缓存头(如Cache-Control, ETag, Last-Modified)。fetch会尊重这些头信息,如果资源未修改,浏览器会直接从缓存中读取,避免重新下载。
  • 请求去抖(Debouncing)和节流(Throttling): 对于用户输入触发的搜索建议、表单验证等频繁请求,使用去抖(例如,用户停止输入500ms后才发送请求)或节流(例如,每500ms最多发送一次请求)可以显著减少服务器压力和不必要的请求。

2. 优化请求本身:

  • 合理使用AbortController 前面提过,这玩意儿太有用了。用户在搜索框里快速输入,或者在页面跳转前,取消掉之前未完成的请求,避免资源浪费和潜在的竞态条件。
  • 并发与串行: 对于多个相互独立的请求,使用Promise.all()进行并发请求,可以大大缩短总等待时间。但对于有依赖关系的请求,则必须串行执行。
  • 数据压缩: 确保你的服务器开启了Gzip或Brotli等压缩,减少传输的数据量。fetch会自动处理解压。
  • 只请求必要数据: 后端API设计时,尽量提供按需获取数据的能力,比如只返回列表的ID和名称,详情则在用户点击时再单独获取。避免一次性返回巨量数据。

3. 提升用户感知性能: 即使请求本身无法再快,我们也能通过一些手段让用户觉得“快”。

  • 加载指示器(Loading Indicators): 在数据加载时显示旋转图标、进度条或骨架屏(Skeleton Screens)。骨架屏尤其推荐,它能模拟页面内容的大致结构,给用户一种内容正在逐渐呈现的错觉,比单纯的加载动画体验更好。
  • 预加载(Preloading)和预取(Prefetching): 对于用户很可能访问的下一页或即将用到的数据,可以在当前页面空闲时提前fetch回来,存储在内存中。当用户实际需要时,数据已经准备就绪,几乎是瞬时加载。
  • 乐观更新(Optimistic UI Updates): 对于一些用户操作(如点赞、收藏),可以先在前端更新UI,假设操作会成功,然后同时发送fetch请求到后端。如果后端返回失败,再回滚UI。这能极大提升用户操作的即时反馈感。当然,这需要谨慎使用,并且要有完善的错误回滚机制。
  • 错误信息的用户友好化: 当请求失败时,不要只在控制台打印错误。给用户展示清晰、易懂的错误提示,并提供解决方案(如“网络连接失败,请检查您的网络设置并重试”)。

这些优化策略并非相互独立,很多时候需要组合使用。在项目初期就考虑这些,会比后期重构要省力得多。毕竟,一个流畅、响应迅速的应用,是用户留下来的关键。

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

542

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

372

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

727

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

470

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

392

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

990

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

654

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

544

2023.09.20

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

7

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 5.8万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 1.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号