前端基于fetch API的请求超时与重试函数封装

2025/3/6
介绍在前端开发里通过封装通用函数实现请求超时和重试功能,给出基于fetch API的示例代码、代码解析及注意事项,该函数有助于处理网络请求不稳定性,提升用户体验。
前端,浏览器,中国程序员

在前端开发中,处理请求超时和重试是一个常见的需求。我们可以通过封装一个通用的函数来实现这个功能。以下是一个基于 fetch API 的示例代码,它支持设置超时时间和重试次数:

/**
 * 封装一个支持超时和重试的请求函数
 * @param {string} url - 请求的URL
 * @param {Object} options - 请求的配置项,同fetch的options
 * @param {number} timeout - 超时时间,单位毫秒
 * @param {number} retries - 重试次数
 * @returns {Promise<Response>} - 返回fetch的响应
 */
async function fetchWithTimeoutAndRetry(url, options = {}, timeout = 5000, retries = 3) {
    for (let i = 0; i < retries; i++) {
        try {
            // 创建一个超时控制器
            const controller = new AbortController();
            const timeoutId = setTimeout(() => controller.abort(), timeout);

            // 发起请求
            const response = await fetch(url, {
                ...options,
                signal: controller.signal
            });

            // 清除超时定时器
            clearTimeout(timeoutId);

            // 如果请求成功,返回响应
            if (response.ok) {
                return response;
            } else {
                throw new Error(`Request failed with status ${response.status}`);
            }
        } catch (error) {
            // 如果是最后一次重试,抛出错误
            if (i === retries - 1) {
                throw new Error(`Request failed after ${retries} retries: ${error.message}`);
            }
            console.warn(`Attempt ${i + 1} failed: ${error.message}. Retrying...`);
        }
    }
}

// 使用示例
fetchWithTimeoutAndRetry('https://api.example.com/data', {
    method: 'GET',
    headers: {
        'Content-Type': 'application/json'
    }
}, 5000, 3)
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error(error));

代码解析:

  1. 超时控制:我们使用 AbortController 来控制请求的超时。如果在指定的 timeout 时间内请求没有完成,controller.abort() 会被调用,从而中断请求。

  2. 重试机制:如果请求失败(包括超时或网络错误),代码会捕获错误并进行重试。重试次数由 retries 参数控制。

  3. 错误处理:如果所有重试都失败,最终会抛出一个错误,提示请求失败。

  4. 使用示例:展示了如何使用这个封装函数来发起一个带有超时和重试机制的请求。

注意事项:

  • 这个实现是基于 fetch API 的,如果你使用的是其他请求库(如 axios),可能需要调整实现方式。
  • 超时时间 timeout 和重试次数 retries 可以根据实际需求进行调整。
  • 在实际项目中,你可能还需要处理更多的边界情况,比如请求取消、网络状态检测等。

这个封装函数可以帮助你在前端应用中更好地处理网络请求的不稳定性,提升用户体验。

标签:面试题
上次更新:

相关文章

npx完全指南:前端开发必备工具详解 | 20年架构师深度解析

本文由20年前端架构师深入解析npx工具,涵盖其核心功能、优势、高级用法、最佳实践及与npm/yarn的区别比较,帮助开发者掌握这一现代前端开发利器。

·前端开发

Astro 静态站点生成器:构建高性能网站的最佳选择

Astro 是一个专注于构建快速、轻量级网站的静态站点生成器,支持多种前端框架,采用岛屿架构减少 JavaScript 加载,提升性能。

·前端开发

Weex 跨平台移动开发框架:核心特性与使用指南

Weex 是由阿里巴巴开源的跨平台移动开发框架,支持使用 Vue.js 或 Rax 构建高性能的 iOS、Android 和 Web 应用。本文详细解析了 Weex 的核心特性、架构、工作流程、组件和模块、开发工具、优缺点、应用场景及未来发展。

·前端开发

ECharts 与 DataV 数据可视化工具对比分析 | 选择指南

本文详细对比了 ECharts 和 DataV 两个常用的数据可视化工具,包括它们的设计目标、优缺点、使用场景和技术栈,帮助读者根据具体需求选择合适的工具。

·前端开发

前端部署后通知用户刷新页面的常见方案 | 单页应用更新提示

本文介绍了在前端部署后通知用户刷新页面的几种常见方案,包括WebSocket实时通知、轮询检查版本、Service Worker版本控制、版本号对比、自动刷新、使用框架内置功能以及第三方库。每种方案的优缺点和示例代码均有详细说明。

·前端开发

file-saver:前端文件下载的 JavaScript 库使用指南

file-saver 是一个用于在浏览器端保存文件的 JavaScript 库,支持生成和下载多种文件格式,如文本、JSON、CSV、图片、PDF 等。本文详细介绍其安装、基本用法、兼容性及与其他工具(如 jszip)的结合使用。

·前端开发

MSW(Mock Service Worker):API 模拟工具的核心优势与使用指南

MSW(Mock Service Worker)是一个用于浏览器和 Node.js 的 API 模拟工具,通过 Service Worker 拦截网络请求,支持 REST 和 GraphQL,适用于开发、测试和调试场景。本文详细介绍 MSW 的核心优势、快速上手步骤、高级用法、适用场景及与其他 Mock 工具的对比。

·前端开发

Preact:轻量级 JavaScript 库,React 的高性能替代方案

Preact 是一个轻量级的 JavaScript 库,提供与 React 相似的 API 和开发体验,但体积更小(约 3-4KB,gzip 后)。它专注于高性能和低资源消耗,特别适合对性能敏感或需要快速加载的 Web 应用。

·前端开发

WASI标准与WebAssembly跨平台生态的未来趋势分析 | 技术深度解析

本文深入探讨了WASI(WebAssembly System Interface)标准的背景、意义及其对WebAssembly跨平台生态的影响。文章分析了WASI在服务器端应用、边缘计算和IoT设备中的应用,以及技术栈和工具链的演进,最后展望了WASI对未来前端开发的影响和最佳实践建议。

·前端开发

WebAssembly沙箱逃逸风险解析及缓解方案 | 前端安全指南

本文深入探讨了WebAssembly(Wasm)在前端开发中的应用及其面临的安全风险,特别是沙箱逃逸问题。文章详细解析了沙箱逃逸的常见途径,并提供了包括内存安全、API安全、JIT安全和宿主环境安全在内的综合缓解方案,以及工程化实践建议,旨在帮助开发人员有效降低安全风险,确保应用的安全性和稳定性。

·前端开发