游乐游手机版
首页/前端开发/文章详情

如何用 Promise.prototype.finally 统一处理无论请求成功还是失败都要隐藏的骨架屏

时间:2026-04-17 14:28
如何利用 Promise prototype finally 统一隐藏骨架屏,无论请求成功或失败 为什么 Promise prototype finally 是隐藏骨架屏的理想选择 核心原因在于其设计初衷:finally 方法专为执行“最终清理”任务而生。它不关心前一个 Promise 最终是成功兑

如何利用 Promise.prototype.finally 统一隐藏骨架屏,无论请求成功或失败

如何用 Promise.prototype.finally 统一处理无论请求成功还是失败都要隐藏的骨架屏

为什么 Promise.prototype.finally 是隐藏骨架屏的理想选择

核心原因在于其设计初衷:finally 方法专为执行“最终清理”任务而生。它不关心前一个 Promise 最终是成功兑现(fulfilled)还是被拒绝(rejected),只要 Promise 状态“已敲定”(settled),它就一定会执行。这完美匹配了“无论接口请求结果如何,最终都必须关闭骨架屏”的通用前端需求。

此外,finally 不接收任何参数,这保证了它不会意外修改链式调用传递下来的值,同时也不会吞噬上游抛出的错误。相比之下,在 thencatch 回调中分别编写隐藏骨架屏的逻辑,不仅会造成代码重复,还容易因遗漏导致界面卡住。finally 提供了一种更简洁、更可靠的一体化解决方案,有效提升代码可维护性。

在 fetch 请求中正确应用 finally 来关闭骨架屏

理解了原理,但实践中仍可能出错。一个常见误区是将 finally 仅放在错误处理分支之后,而忽略了成功处理链路中也可能抛出异常(例如 JSON 解析失败),这会导致骨架屏在某些情况下无法隐藏。

正确的做法是,将 finally 置于整个 Promise 链的末端,作为最终的、必然执行的清理步骤:

showSkeleton();
fetch('/api/data')
  .then(res => {
    if (!res.ok) throw new Error(`HTTP ${res.status}`);
    return res.json();
  })
  .then(data => render(data))
  .catch(err => handleError(err))
  .finally(() => hideSkeleton()); // 确保在任何情况下都会执行

当然,使用async/await语法也非常普遍。需要注意的是,finally不能直接跟在await表达式后面,此时经典的try...catch...finally语句块就成为了最佳选择:

showSkeleton();
try {
  const res = await fetch('/api/data');
  const data = await res.json();
  render(data);
} catch (err) {
  handleError(err);
} finally {
  hideSkeleton(); // 同样是最终的收尾位置
}

注意:在 finally 中修改共享状态可能引发竞态条件

这是在处理并发请求时容易遇到的进阶问题。设想一个场景:页面同时发起多个请求,它们共享同一个骨架屏的加载状态(例如一个全局的 isLoading 变量)。如果每个请求都在自己的 finally 回调中直接设置 isLoading = false,那么最先完成的请求会过早地关闭骨架屏,而此时其他请求可能仍在加载,导致页面状态混乱,用户体验受损。

如何解决这个并发请求下的骨架屏管理难题?以下是几种有效的策略:

  • 采用请求计数器:发起请求时执行 pendingCount++,在 finally 回调中执行 pendingCount--,并仅在计数器归零时,才真正执行隐藏骨架屏的操作。
  • 借助现代状态管理工具:使用 AbortController 进行精细的请求控制,或者直接采用如 React Query、SWR、VueUse 等前端数据请求库,它们内置了智能的 Loading 状态管理,能自动处理并发场景。
  • 从架构设计上隔离状态:避免使用全局共享的加载状态,改为让每个独立的 UI 组件或视图模块维护自身的 isPending 状态,由前端框架(如 React、Vue)来协调最终的渲染逻辑。

finally 不会阻止错误传播,但需警惕其潜在影响

这是一个关键但常被误解的特性。finally 执行完毕后,原始的 Promise 拒绝原因并不会被“消化”或阻止,它仍然会继续向调用链的上层传播。也就是说,finally 本身并非错误处理器。

然而,有一个重要的细节:如果你在 finally 回调函数内部主动 throw 了一个新的错误,或者返回了一个被拒绝的 Promise,那么这个新产生的错误将会取代并覆盖掉链中可能存在的原始错误。反之,如果 finally 回调正常执行完毕,则完全不影响错误的原有传播路径。因此,下面这种写法是安全的:

fetch('/api/data')
  .then(handleSuccess)
  .catch(handleError) // 在此处捕获并处理错误
  .finally(() => hideSkeleton()); // ✅ 执行后,任何未被捕获的错误仍会正常向外抛出

而下面这种写法则会带来问题,因为它掩盖了原始错误:

.finally(() => {
  hideSkeleton();
  return Promise.reject(new Error('finally broke it')); // ❌ 这个新抛出的错误会覆盖掉链中任何原有的错误信息
})

总而言之,在实际前端开发中,只要牢记finally最适合用于执行那些不改变最终结果、无副作用的“清理”操作——例如更新DOM状态、记录日志、清除定时器或隐藏骨架屏——就能安全地利用它,而无需担心它会破坏应用程序整体的错误处理流程。掌握这一点至关重要。

来源:https://www.php.cn/faq/2334678.html
上一篇index.html里如何设置超链接的四种状态样式? 下一篇如何利用 console.groupCollapsed() 将关联的复杂组件初始化日志折叠收纳以提升调试效率
本站内容用于信息整理与展示,如有侵权或内容问题请及时联系处理。

相关推荐

补充同频道和同主题内容,方便继续浏览更多相关内容。

同类最新

继续查看同栏目最近更新的文章。

更多
checked表单属性与CSS变量实现换肤原理
前端开发 · 2026-07-02

checked表单属性与CSS变量实现换肤原理

先聊一个有意思的现象:不需要编写任何 JavaScript,仅靠一个 :checked 伪类,就能驱动整个主题切换系统。听起来很神奇,但原理其实并不复杂——核心在于,:checked 是浏览器原生状态的实时镜像,而不是 JS 模拟出来的开关。 用户点击 ,或者用键盘空格键选中它,状态更新的那一刻,C

HTML meta标签页面定时跳转实现
前端开发 · 2026-07-02

HTML meta标签页面定时跳转实现

说到前端开发中最简洁的页面跳转方式,meta http-equiv= "refresh " 绝对算得上一个经典方案。不过别看它结构简单,格式上稍有疏忽,页面就可能原地卡死,或者直接跳到一个错误地址。下面把几个最容易踩坑的细节彻底讲清楚,帮你避开这些常见陷阱。 使用 http-equiv= "refresh

Cypress跨测试用例状态传递的不推荐但可选方案
前端开发 · 2026-07-02

Cypress跨测试用例状态传递的不推荐但可选方案

Cypress 默认的设计哲学很干脆:每个测试用例都必须是独立小王国,谁也不靠谁。这意味着 it() 执行前,浏览器上下文会被“一键还原”——页面状态、LocalStorage、Cookies 统统清空,强制维护测试隔离。这一规则让很多新手头疼:明明前一个测试已经创建了员工,后一个测试怎么就没法直接

全面深度解析HTML主体main标签唯一性原则与使用规范
前端开发 · 2026-07-02

全面深度解析HTML主体main标签唯一性原则与使用规范

在进行前端无障碍审计时,不少开发者会遇到一个奇怪的场景:浏览器不报错,但Lighthouse却直接标红“duplicate-main”。这其实是语义层与渲染层之间的根本差异。 为什么浏览器不报错但 Lighthouse 直接标红 duplicate-main 关键原因就在于:`main` 是语义锚点

HTML main标签在文档结构中的唯一性详解
前端开发 · 2026-07-02

HTML main标签在文档结构中的唯一性详解

先做一个快速检测:打开你最近开发的一个页面,按下 Ctrl+F 搜索 。如果搜索结果里出现2个以上,那这篇文章建议你认真读完。 本期要聊的主题,是HTML标签中一个看似简单、实际极易踩坑的核心知识点:main标签的唯一性。很多开发者知道这个标签的存在,但真正写到项目里,尤其是用了React、Vue这