JavaScript 中怎么实现富文本图片上传失败的队列重试

轻静酱_7576

轻静酱_7576

2026-09-28

128人浏览

原创

图片上传失败后自动重试的核心是构建可重试任务单元、失败后暂存队列、按需触发重试、执行时保障幂等性与dom同步,并全程管理任务生命周期。

javascript 中怎么实现富文本图片上传失败的队列重试

富文本编辑器中图片上传失败后自动重试,核心是把失败的上传任务存入队列,并在条件满足(如网络恢复、手动触发、定时轮询)时重新执行。关键在于任务状态管理、错误隔离、重试策略和与编辑器 DOM 的同步。

1. 构建可重试的上传任务单元

每个图片上传应封装为一个独立、可序列化、带元信息的任务对象,便于存储、重试和 UI 反馈:

  • 包含原始文件或 base64 数据:避免重试时再次读取 input 或 canvas(推荐暂存 blob URL 或 File 对象引用,若需持久化则转为 base64 或用 IndexedDB 存二进制)
  • 携带编辑器节点定位信息:如插入位置的 editor.getSelection().anchorNode 或自定义 data-id,确保重试成功后能准确替换占位符 img 标签
  • 记录重试次数和最大限制:例如 retryCount: 0, maxRetries: 3,防止无限循环
  • 保存上传前生成的临时占位符:比如插入一个带 data-upload-pending="true" 和唯一 data-task-id 的 img 标签,失败时保留它,成功后替换 src 并移除属性

2. 失败捕获 + 队列暂存(内存 or 持久化)

在上传 Promise reject 后,不直接报错,而是将任务推入重试队列:

Alibabacloud Sdk Client Initialization For Java
Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载
  • 内存队列适用场景:单页应用、短时离线、用户不刷新页面。可用 const retryQueue = [] 管理,配合 Array.prototype.unshift()(优先重试最新失败项)或 push()(FIFO)
  • 需要持久化时:使用 localStorage 存 JSON 序列化任务(注意 base64 过大会超限),或更可靠地用 IndexedDB 存文件 blob + 元数据;重试前从存储恢复队列
  • 拦截并标记失败图片:找到对应占位符 img,添加 data-upload-error="true" 和错误提示 title,UI 上可显示「⚠️ 上传失败,点击重试」

3. 触发重试的几种实用方式

不依赖固定时间轮询,按需响应更友好:

  • 监听网络状态变化:用 window.addEventListener('online', () => startRetry()),适合离线后恢复场景
  • 用户主动点击重试:为每个失败图片绑定 click 事件,调用 retryTask(taskId) 单独重试,或全局「重试全部」按钮
  • 定时轻量探测 + 智能延迟:对队列中任务设置指数退避(如第 1 次 1s 后、第 2 次 3s 后、第 3 次 7s 后),用 setTimeout 调度,避免并发冲击服务端
  • 编辑器空闲时自动重试:监听 editor.on('blur') 或 setTimeout(() => { if (isIdle) startRetry() }, 2000),减少干扰用户输入

4. 重试执行与结果同步

重试不是简单再发请求,需保障幂等性和 DOM 一致性:

  • 上传前校验任务有效性:检查文件是否仍存在(File 对象可能因页面刷新失效)、占位符 DOM 是否还在、编辑器是否已销毁
  • 使用相同签名防重复提交:对文件内容计算简易 hash(如 size + lastModified),或服务端支持 idempotency-key,避免同一图被传多次
  • 成功后精准更新 DOM:根据 task 中保存的 data-task-id 找到对应 img,替换 src,移除 data-upload-pending 和 data-upload-error,可加淡入动画
  • 最终失败要降级处理:如重试 3 次均失败,提示用户「图片上传失败,请检查网络或更换图片」,并提供删除占位符按钮

不复杂但容易忽略的是任务生命周期管理——上传开始时加 loading 状态、失败后进队列、重试中禁用重复点击、成功后清理内存和 DOM 标记。把每次上传看作一个有始有终的“事务”,队列就自然健壮了。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

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

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

2023.06.20

4266

5

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

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

2023.07.04

1089

3

js四舍五入
js四舍五入

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

2023.07.04

4184

6

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

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

2023.09.01

860

4

JavaScript转义字符
JavaScript转义字符

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

2023.09.04

1736

5

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

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

2023.09.04

3105

4

如何启用JavaScript
如何启用JavaScript

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

2023.09.12

4033

6

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

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

2023.09.20

2600

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

848

7

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.5万人学习